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Chapter 1 


Introduction 


I ho Nat ional Aeronautics and Space Administration's interest in viscous, hypersonic flow- 
field simulat ion has grown in recent years in anticipat ion of the design needs for space transporta- 
1,0,1 a,Kl ex P lorat i°n over the next three decades, e.g., Walberg (ref. 1). Proposed aeroassisted 
space transfer vehicles will use the upper layers of planetary atmospheres in hypersonic aero- 
braking maneuvers. Supersonic combustion ramjet engines are being designed to propel vehicles 
at hypersonic speeds through the Earth's atmosphere to orbit. Various concepts for a single- 
stage- t.o-orbit (SSTO) vehicle are now being considered. The external flow field surrounding 
such vehicles, as well as the internal flow field through the scramjet engine and nozzle, can 
be significantly influenced by thermochemical nonequilibrium processes in the flow. Accurate 
simulations of these phenomena would provide designers valuable information concerning the 
aerodynamic and aerot hermodynamic character of these vehicles. 

This user's manual provides detailed instructions for the installation and the application of 
version 4.1 of the Langley Aerot hermodynamic Upwind Relaxation Algorithm (LAURA) (refs. 2 
and .$). which is a program for obtaining the simulations discussed above. Earlier versions of 
LAI RA were predominantly research codes, and they had minimal (or no) documentation. This 
manual describes UNIX-based utilities for customizing the code for special applications that also 
minimize system resource requirements. The algorithm is reviewed, and the various program 
options are related to specific equations and variables in the theoretical development . 

I wo major challenges exist to the simulation of flow fields in thermochemical nouequilib- 
nnm around vehicles traveling at hypersonic velocities through the atmosphere. First, these 
simulations require modeling of the nonequilibrium processes in the flow; these processes fre- 
quently occur at energies in which the models currently lack sufficient experimental or analytic 
validation. Second, because of the large number of unknowns associated with chemical species 
and energy modes and because of disparate time scales within the flow field, these simulations 
require algorithmic innovations to maintain numerical stability and fully exploit supercomputer 
resources. 

Nonequilibrium processes occur in a flow when the time required for a process to accom- 
modate itself to local conditions within some region is of the same order as the transit time 
across the region. The equations and the models used in this manual for nonequilibrium flow 
have been documented in reference 4, and they were substantially derived from the work of Park 
(rels. 5 and (i) and Lee (ref. 7). Calibration and validation of the physical models intrinsic to 
this code were first discussed in reference 8. Other code development and calibration programs 
(e.g. CASE (refs. !) to 11), Candler (ref. 12), Candler and MacCormack (ref. 13). Park and Yoon 
(ief. 14), Netterfield (ref. 15). and Coquel et. al (ref. 1 fi ) ) are now in progress within the area, of 
viscous, hypersonic, reacting gas flow field simulations. 
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Numerical stability is maintained through an implicit treatment of the governing equations. 

A great variety of implicit treatments is possible. For problems in which only the steady-state 
solution is required, one is free to evaluate any element of the difference stencil at any itera- 
tion (pseudo-time) level which facilitates the relaxation process. In the most rigorous implicit 
treatment, all variables in all cells are simultaneously solved at an advanced iteration level, thus 
requiring the solution of a linearized equation set involving (n x / x .7 X A ) equations where 
i s the number of unknowns at a cell and I, J, and K are the number of computational cells 
in the three respective coordinate directions. The various forms of factored implicit schemes 
and line relaxation methods sequentially solve equation sets involving {n x /), (n x ./). and/or 
( n X I\) variables. The point-implicit schemes, as utilized in the present work, sequentially solve 
equation sets involving n simultaneous, linearized equations. Further simplification is possible 
in chemical kinetic problems by linearizing contributions to the residual from only the source 
terms to alleviate problems of disparate chemical time scales, thus resulting in methods which 
involve no matrix operations. 

Th e essence of the point-implicit strategy is to treat, the variables at the cell center of interest 
implicitly at the advanced iteration level and to use the latest available data from neighbor cells 
in defining the “left-hand-side” numerics. The success of this approach is made possible by t he 
robust stability characteristics of the underlying upwind difference scheme. Even simulations of 
thermochemical nonequilibrium flows in a near-equilibrium state can be handled by this approach 
(ref 17) The algorithm requires only a single pseudo-time level of storage and is efficiently 
implemented on vector or parallel processors (ref. 18). Details of the relaxation algorithm, 
including effects of a gas in thermal and chemical nonequilibrium, are presented herein. 

As noted above, there is no requirement to synchronize the evolution of the solution at 
neighboring points in the single-level-storage point-implicit relaxation strategy. Consequently, 
algorithm parallelization can be implemented on a subroutine level across several domains with- 
out the need to synchronize tasks or restrict parallel code to a “do loop” level. Scalar code and 
conditional logic do not inhibit parallel efficiency. Dynamic allocation of resources to domains 
that are slow to converge is enabled in this environment. These capabilities are exploited on 
('RAY class computers and are discussed in greater detail within this manual. 

The code and the user interface are structured to make liberal use of FORTRAN include state- 
ments that tailor the resource requirements for each case to a minimum. System requirements 
vary from standard workstations for many perfect-gas applications to 128 Mw (megaword) m- 
core memory. 128 Mw of “fast disk” (SSD) memory, and more than 100 central processing unit 
(CPU) hours to obtain a converged solution on a CRAY YMP for thermochemical nonequilib- 
rium flow (seven species) over the Space Shuttle with the thin-layer Navier-Stokes equations 
using a grid of 150 x 109 x 60. 

This manual is designed to guide the user through the application, beginning with the in- 
stallation of the source code on a given machine. Chapter 2 contains an outline of this manual, 
and provides an overview of the LAURA algorithm. 
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Chapter 2 


Overview 


This chapter provides an overview of the LAURA algorithm, and it can he skipped by the 
experienced user. Chapter d is a checklist (a brief outline of the entire procedure) which is useful 
(or the experienced user who needs a quick review. Chapter 4 is a quick reference guide to the 
utilities and commands of LAURA. Chapter 5 details the source-code installation procedure. 
Ilie setup procedure for a particular application is given in chapter (>, and the menus of the 
startup routine are given in chapter 7. Chapters # and 9 discuss the compilation and execution 
of LAURA, respectively, and chapter 9 describes the resultant output files. Approaches for a 
number of advanced applications are presented in Chapter 11. The various appendixes provide 

• a sample case (appendix A) 

• the equations for conic geometries (appendix H) 

• the details of the various script files employed by LAURA (appendixes C to N) 

• an in-depth discussion of the LAURA algorithm (appendix 0) 

• the FORTRAN variables discussed in this document (appendix P) 

• the FORTRAN flags changed through data (appendix Q) 

• the FORTRAN flags changed through stArt (appendix R) 

• the FORTRAN flags changed through file edits (appendix S) 

Although not a requirement, in hypersonic blunt-body applications, the origin of the coordi- 
nate system generally sits at or near the stagnation point on the body, with the --axis pointing 
out from the body toward the oncoming flow, as shown in figure 2.1. The y = 0 plane defines 
the symmetry plane. Lifting-body applications retain this orientation in which the origin of (he 
coordinate system is at or near the vehicle stagnation point, the s-axis points out from the nose, 
against (lie flow, and the negative --axis typically runs through the interior of the vehicle. 

Computational coordinates (£, //, <,') run in the direction of increasing and /(-indices, 

respectively, as shown in figure 2.2. The vehicle surface grid is usually defined by the - 1 
plane to enhance convergence t hrough the use of over- relaxation of the viscous terms and special 
limiters when sweeping across the boundary layer, although other orientations are permitted. 




Figure 2.1. Typical orientation of (’artesian coordinate system with respect to blunt body in 
LAURA. 



Figure 2.2. Typical orientation of computational coordinates over winged vehicle showing two 
computational planes. 
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Figure 2.:i. Subdirectory layout, for LAURA. 

NOTE: Options for automatically aligning the grid with the captured bow shock 
and resolving the boundary layer require this orientation with k = I on 1 ho surface. 

lhe first, step in applying LAURA to a given problem involves installation of the source 
code on the computer where the computations will be performed (chapter 5). LAURA has been 
successfully tested on SUN. CRAY, SGI. and CONVEX architectures. The LAURA package 
is distributed as two files, LAURA .4 . 1 . tar . Z and INSTALL_LAURA .4.1, which should be placed 
in the user’s $H0ME directory. File LAURA. 4. 1 .tar .Z is a. tarfile (tape archival file) which 
contains the LAURA source code. The file INSTALL_LAURA .4.1 is a script that executes the 
installation procedure. 

NOTE: LAURA requires a UNIX operating system, and assumes the user has some 
familiarity with UNIX protocol. 

LAURA is based on the premise that the bulk of the LAURA source code does not change 
from one application to the next. These files, which should rarely require modification, are kept 
in $HOME/LAURA . 4 . 1, which is a read-only directory. 

By default, LAURA uses the SH0ME/LAURA.4. 1 source files, in conjunction with application- 
specific coding created through user-inputs to PRELUDE (the LAURA preprocessor). For further 
tailoring, the user can create a LOCAL version of any LAURA source file. This LOCAL file will be 
used for compilations from this working (LOCAL) directory only. This LOCAL file can be converted 
to a CUSTOM file if t he user wishes to make it the default (in lieu of the $HOME/LAURA .4.1 version ) 
fiom any working directory. If a CUSTOM version of a file is encountered during compilation, it is 
used in lieu of the $H0ME/LAURA.4. 1 version. If a LOCAL version of a file is encountered during 
compilation, it is used in lieu of the $H0ME/LAURA.4. 1 version and the CUSTOM version (if one 
exists). 

I igure 2..J shows the relationship between (and roles of) the various directories employed bv 
LAURA. The headers on each box are directory names, and the contents of each box are file 
types located in that directory. Solid lines indicate required files and directories, and the dashed 
lines indicate files and directories whose existence is dependent on which advanced features have 
been utilized. 
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To run LAURA interactively, type the command 

(laura < data > lfn) 


This command sends the output to file lfn. User control of a given run is provided through the 
input files and the include files with the . strt suffix (chapter 9). 

A typewriter style is used to denote file names and directories, as well as FORTRAN coding. 
Italics are used for variable names and for units of measure. Shaded boxes with thin borders 
and sharp corners are used to denote contents of a file. Shaded boxes with thick borders and 
rounded corners are used to denote screen prompts. Commands that the user types are contained 
in smaller shaded boxes with thin borders and rounded corners. 

The term LOCAL refers to files in the present working (or LOCAL) directory, which will lie used 
in lieu of the installed files within this directory only. The term CUSTOM refers to tailored files 
that are used in lieu of the installed files from any working directory. 
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Chapter 3 


LAURA Quick Reference Guide 


This chapter discusses the installation, 
and is intended as a quick reference guide. 


the specialization, and the application of LAURA 


3.1. Installation 

Io install LAI RA, complete the following steps: 

• Place files LAURA .4 . 1 . tar . Z and INSTALL_LAURA .4. 1 in the $H0ME directory (chapter 5). 
I* 'le LAURA . 4 . 1 . tar . Z should be read-only; if not, type 

(chmod 400 LAURA. 4. l.tajTTz) 

the file INSTALL_LAURA.4. 1 should be executable; if not, type 

(chmod 500 INSTALL-LAURA .4,1*) 

• Type the command 

(INSTALL -LAURA .4.1^) 

to install the LAURA source code on this machine (chapter 5). 

3.2. Specialization 

For specialization, do the following: 

• Create (and change to) a working (LOCAL) directory. 

• Type 

(prelude) 

to create the subdirectories that LAURA requires (chapters (j and 7). For some advanced 
applications, the stArt executable may require tailoring. In such cases, the desired changes 
should be made (via LOCAL or CUSTOM source files for stArt) before running PRELUDE. 



to compile laura. the LAURA executable (chapter 8). For advanced applications, fur- 
ther tailoring of LAURA may be required (chapter 11) before executing make. If so, use 
LOCALIZE to create LOCAL versions of files for necessary modifications. If CUSTOM files 
containing the desired changes already exist, this step is not required. 





NOTE: The laura executable must be recompiled after changes to any LAURA 
FORTRAN files (.F. .FOR. .f, . inc, or .strt suffixes). 

3.3. Application 

For LAURA application, complete the following steps: 

• Review LAURA input files (chapter 9) and modify, if necessary. 

• To run interactively, type the command 

(laura < data > lfn) 

to run LAURA and send the output to file lfn. Individual runs are controlled via the 
LAURA input files (chapter 9). 

• The LAURA output files are discussed in chapter 10. 
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Chapter 4 

Summary of LAURA Utilities 

A summary of LAURA utilities is given below. The utility is listed in the left column, and 


its function i: 

s given in the right column. 

ARCHIVE 

saves the LOCAL. CUSTOM, and input files for the present working (LOCAL) 
directory 

BLOX 

exchanges data between the working files (RESTART, in and TWALL.in) 
and their master files (RESTART. MASTER and TWALL. MASTER) 

CUSTOMIZE 

moves the LOCAL file to the CUSTOM directory: the CUSTOM file will be used in lieu 
of the $HOME/LAURA .4.1 version in fut ure LAURA applications 

INITIALIZE 

accepts a grid from a. file in the PL0T3D format., initializes the flow field to the 
free-stream values, and creates RESTART. in 

KEEPER 

makes backup copies of files RESTART, in. RESTART. MASTER. 
TWALL.in. and TWALL. MASTER 

LOCALIZE 

creates a LOCAL version of the $H0ME/LAURA .4.1 file; it is used in lieu of 
the $H0ME/LAURA.4. 1 version in this LOCAL directory 

RESTORE 

restores the archived files to the present working (LOCAL) directory 

SIZEIT 

estimates the memory requirements of a given application, based on the values 
specified in the files parameter . strt and assign.tasks 

XCUSTOM 

eliminates a. customized file 
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Chapter 5 

Source Code Installation 


LAURA lias been successfully tested on SUN, CRAY, SCI. and CONVEX architectures. 
The first step in applying LAURA to a given problem involves the installation of the source 
code on the computer where the computations will be performed. The LAUR A package consists 
of two files. LAURA. 4. 1 .tar.Z and INSTALL_LAURA.4. 1. which should be placed in the user's 
$HOME directory. File LAURA. 4. 1. tar.Z should be read-onlv: if not. type 


(chmod 400 LAURA .4. l.tar.Z^ 
I he file INSTALL_LAURA .4 . 1 should be executable; if not, type 


(chmod 500 INSTALL-LAURA.4. l) 

The source code for LAURA is contained in LAURA .4 . 1 .tar .Z, which is a tarf ile (tape archival 
file). Typing the command 

( INSTALL -LAURA .4. l) 

executes the relatively straightforward procedure (appendix C). which is outlined below. 


1. A subdirectory named LAURA. 4.1 is created in the user’s $H0ME directory. 

2. The LAURA source code, contained in the following files, is extracted from LAURA .4.1. tar . Z 

and placed in directory $HOME/LAURA .4.1. These files include 

(a) Files with the start, root, which contain the source code for stArt, the LAURA 
start-up routine (discussed in chapters 6 and 7) 

(b) The script PRELUDE that serves as the front-end to stArt 

(c) Files with a .F suffix, which contain LAURA subroutines: these files have a FOR 
suffi x on CONVEX architectures 

(d) Files with a . inc suffix, which contain additional FORTRAN coding (such as COMMON 
blocks): the information in these files is accessed by various LAURA subroutines 
through include statements 

(e) I he file vinokur . data, which supplies the coefficients for Vinokur’s curve-fits 

(f) The file mAch+prOc.c, which is a C program used to determine the machine architec- 
ture and number of available processors 

(g) 1 he data file DEFAULTS, which supplies default values to stArt 
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(h) The script files Makedep, Makedep . awk, and SYMLINKS, which are used by the Makefile 
(appendix E); these files must be executable 

(i) The following utilities (which are detailed in the appendixes); these script files must 
be executable: 

ARCHIVE INITIALIZE RESTORE 

BLOX KEEPER SIZE IT 

CUSTOMIZE LOCALIZE XCUSTOM 

(j) The following FORTRAN source files: 

array. f flowinit.f makeblk.f 

exchange . f f lowinit . inc sizeit.f 

3. The 0 program mAch+prOc is compiled and run to determine the machine architecture and 
number of available processors. 

4. 'file ARCHIVE, CUSTOMIZE. KEEPER. LOCALIZE. PRELUDE. SYMLINKS. and XCUSTOM scripts are 
tailored to this architecture. 

5. The program start. f is compiled to create the executable stArt. Also, the executables 
ArrAy, flOwInlt. mAkEblk. and sIzEIt are created from the FORTRAN source files listed 
above. 

6. The data file DEFAULTS is tailored to this machine. 

7. The user’s .cshrc file is checked to see if aliases for the supporting script files of LAURA 
have been established. If not., the user is given the option to add aliases for these scripts 
(ARCHIVE, CUSTOMIZE. KEEPER, LOCALIZE, PRELUDE, and XCUSTOM). These aliases allow 
execution of these commands from any working (LOCAL) directory in the user’s account 
without having to enter the full path name. 

At this point the installation procedure is complete. 

NOTE: Type 

to activate the new aliases for this shell. 
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Chapter 6 


Setup for LAURA Application 


Alter installation, the first step in applying LAURA to a specific problem involves creating 
a. working (LOCAL) directory, either in scratch space or in a permanent subdirectory. The files 
in the working directory, are referred to as LOCAL files in this manual. Within this directory. 
PRELUDE is executed to create the required infrastructure for LAURA. PRELUDE also executes 
stArt, which allows the user to tailor LAURA to an application by selecting items from a 
seiies of menus (chapter 7). Defaults for these menu prompts are supplied by the file DEFAULTS 
(section 0.2), while the user inputs are written to the file INPUTS (section 0.3). The user-defined 
choices tailor LAUR A t hrough FORTRAN parameter statements, compile directives, and include 
files. 1 he file Makefile is also constructed based on these selections. As a result, only the 
code and memory required for this application are activated during compilation. A thorough 
discussion of PRELUDE is presented in section 0.1. Its anatomy is given in appendix D. 

For most applications, a successful run of PRELUDE is followed by the make command, which 
compiles the LAURA source code to create laura (the LAURA executable). The features 
of the LAURA Makefile are discussed in chapter 8. Its anatomy is given in appendix E. 
sec tion L. 1 . For certain advanced applications, additional tailoring (chapter 1 1 ) may lie required 
after running PRELUDE. This involves modifying LOCAL copies of LAURA files before compilation, 
as described in section (j. L 

( liapter 9 discusses actually running LAURA. Specifically, this chapter provides details on 
the input files that give the user control of a given run. The LAURA output files are described 
in chapter 10. 


6.1. Workspace Layout 

The command PRELUDE serves as the front-end for stArt. which performs the following 
functions: 

• Case-specific include files (with .strt suffixes) containing FORTRAN coding are created. 

• Up to three input data files are created by stArt for LAURA, depending on the following 
user inputs: 

- data: This file, which provides control of LAUR A, is always generated by stArt. The 
roles of its various entries are discussed in section 9.1.3. 

RESTART, in: This is the restart file for LAURA, which allows the current run to pick 
up the solution where the previous one left off. For externally generated grids, this fde 
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must be supplied by the user. Otherwise, stArt provides a “cold-start" RESTART . in 
file (section 9.1-1). 

- TWALL.in: This is the restart file for the wall temperature distribution (section 9.1.5). 
It is only used by LAURA when the “radiative equilibrium wall temperature" option 
is active, and only created by stArt when that particular option is selected by the 
user. 

• The user inputs from this run of stArt are saved in files DEFAULTS and INPUTS. 

In addition to activating stArt, several other tasks are performed by PRELUDE. 

• Subdirectories OBJf iles and STRTf iles are created in the working (LOCAL) directory. The 
OBJf iles will ultimately contain the object files and executable file, which are created by 
make. STRTf iles will contain the FORTRAN files ( .strt suffixes) created by stArt. PRELUDE 
executes stArt and then moves the resultant files to the STRTf iles directory. 

• By default , the $HOME/LAURA .4.1 stArt executable is used. However, if any LOCAL versions 
of stArt source files exist, compilation is performed to create a LOCAL version of stArt (if 
it is outdated). If no LOCAL stArt source files exist, the existence of CUSTOM stArt source 
files is considered. If they do exist, a CUSTOM stArt executable is compiled (if it requires 
updating). 

• Before stArt is executed, if any LOCAL case-specific include files ( .strt suffixes) already 
exist, the user is given the option to retain them. 

• If file data, RESTART . in, or TWALL . in already exists in the working (LOCAL) directory, the 
user is given the option to keep the old file or update it. 

With each PRELUDE run, DEFAULTS supplies the default values (which are echoed to the screen) 
for the user inputs to stArt (section 6.2). The INPUTS file reflects only those values selected 
in the last execution of PRELUDE (section 6.3). If for any reason (file corruption or deletion, for 
example) the user needs to repeat this initialization, the command 

(prelude inputs) 

reproduces all of the files produced by stArt without further user input. 

6.2. DEFAULTS File 

The default values for the variables of the stArt menus are supplied through the LOCAL file 
DEFAULTS. These values are echoed to the screen for their respective menus. Initially, this file is 
copied from $H0ME/LAURA.4. 1. With each execution of PRELUDE, DEFAULTS is updated to reflect 
user inputs. This feature provides the user with an on-line reminder of previous values. 

NOTE: Acceptance of the default values defined in the $HOME/LAURA .4.1 version 
of the DEFAULTS file will generate the initial grid and flow field for the case discussed 
in appendix A. 

The first section of DEFAULTS contains the LAURA version number as well as the machine 
time and number of available processors (screen 1). This section is determined during the 
installation of the code on a given machine. The next section of DEFAULTS contains general 
information, including free-stream conditions. 


14 



1 

nprocs 


2 

1 

newjob 

ndim 

0-externally generated, l=conic, 2=aerobrake 

1 

5000.00 

igovern 

vinfb 


0. 100000e-02 

rinfb 


200.000 

tinf 


0 . 

attack 


0 . 

yaw 


0 

500.000 

tempbc . Tw BC: 
twall 

0-constant, l=variable, 2=radiative equilibrium 

0 . 

ept 



Screen 1. 

NOTE: In version I.I of LAURA, the yaw angle is set to yaw = (). 
I he next section (screen 2) concerns the gas model. 


0 

ngas 


model: 0=PG, 1=EQ, 2=N0»EQ 

0 

icrv 


0 

itherm . . . . 


-T) , 2=nonequilibrium (2-T) 

n 

answern . . . 


atomic nitrogen (y/n)?.... 

n 

ansvero . . . 


atomic oxygen 

n 

answern2 . . 


molecular nitrogen 

n 

answero2 . . 


molecular oxygen. 

n 

answerno . . 


nitric oxide 

n 

answernp . . 


ionized atomic nitrogen. . . 

n 

answerop . . 


ionized atomic oxygen 

n 

answern2p . 


ionized molecular nitrogen 

n 

answero2p . 


ionized molecular oxygen. . 

n 

answernop . 


ionized nitric oxide 

0 

jtype 


. . catalytic nature of wall 

0 

nturb 

. turbulence: 0=no, l=Cebeci-Smith, 2=Bald»in-Lomax 


Screen 2. 


The third section (screen 3) contains default values to the controls for the computational 
domain. 
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1 nblocks number of computational blocks 

30 iblk( 1) block 1: cells in i-direction 

1 jblk( 1) 1: cells in j-direction 

64 kblk( 1) 1: cells in k-direct ion 

4 itype (1 , 1) block 1: nature of i = 1 boundary 

1 itype (2, 1) 1: nature of i = 30 boundary 

5 itype (3, 1) 1: nature of j = 1 boundary 

5 itype (4, 1) 1: nature of j = 1 boundary 

0 itype (5, 1) 1: nature of k = 1 boundary 

3 itype (6, 1) 1: nature of k = 64 boundary 


Screen 3. 

NOTE: Initially, defaults are assigned for a single computational block. If more 

than one block is specified in stArt. the updated DEFAULTS file will contain the 
dimensions and boundary conditions for t hese additional blocks. 


The final section (screen 1) contains the geometry information. 


q iirnit , , units : 0— m» 1—cm, 2 ft, 3 in, 4“ — 

m unit 1- or 2-character abbreviation for custom units 

1.00000 rflngth conversion factor for custom units 

0. xcg x ” c s ] 

0. zcg f** 1 

3.14159 refarea reference area [m ~2] 

2.00000 ref len reference length [m ] 

1 ndimb body dimension: l=axisymmetric , 2=2-D, 3=3-D 

2 q ic number of cells on cap 

1 konic .... {l=hyper, 2=para}boloid, {3=elliptic-, 4=sphere-}cone 

the half -angle [deg] of asymptote 

1.00000 b axial shape parameter for nose 

1.00000 mose nose radius [m ] 

1.00000 rxz nose radius [m ] in symmetry plane 

1.00000 zmax bod y length [m ] 

1.00000 axfac axial stretching factor for grid 

l iafe aerobrake option: 0=AFE, l=hemisphere, 2=custom 

1.00000 scale aerobrake scale factor 

0 thetaxy b ° d y half-angle [deg] 

90.0000 delta rake le ^eg] 

q tau shoulder turning angle [deg] 

0 radius shoulder radius [m ] 

1.00000 epsib eccentricity of nose 

1.00000 rbase base plane radius [m ] 


Screen 4. 
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6.3. INPUTS File 


Each time PRELUDE is successfully run, an INPUTS file is created which contains the user 
inputs of that session. As such, it is a subset of the DEFAULTS file, since no single run will reset 
all of the default values. (For example, if perfect gas flow is chosen, the user does not choose an 
equilibrium curve-fit.) To illustrate, the INPUTS file (screen 5) for appendix A is shown below. 


2 

newjob . 

0=externally generated, l=conic, 2=aerobrake 

1 

ndim . . . 


1 

igovern 

fluid eqns : 0=Euler, 1=TL N-S, 2=N-S 

5000.00 

vinfb . . 


0.100000e-02 

rinfb . . 


200.000 

tin! . . . 


0 

tempbc . 

Tw BC: 0=constant , l=variable, 2=radiative equilibrium 

500.000 

twall . . 


0 

ngas . . . 

gas model: 0=PG , 1=EQ , 2=N0NEQ 

0 

nturb . . 

turbulence: 0=no, l=Cebeci-Smith, 2=Baldwin-Lomax 

30 

iblk( 1) 

cells in streamwise/axial direction 

64 

kblk( 1) 


1 

iaf e . . . 

aerobrake option: 0=AFE, 1 hemisphere , 2=custom 

1.00000 

scale . . 



Screen 5. 

This example employs the self-starting capability for axisymmetric flow about a sphere-cone 
(specified in ft ). The thin-layer Navicr- Stokes equations will be solved. The perfect gas, the 
laminar flow, and a constant wall temperature are specified. The command 

(prelude inputs) 

instructs PRELUDE to accept user inputs from file INPUTS, rather than from the screen. 

NOTE: Some changes to file INPUTS can result in a different question and answer 
sequence in stArt. For example, to change from icm = 1 to icrv ~ 2, a user can 
elect to simply change its value in file INPUTS and type the command 

(prelude ihputs) 

However, this approach will not work for switching from ndim — 1 to ndim — 2, 
because PRELUDE prompts for angle of attack with two-dimensional flows, but it does 
not prompt for axisymmetric flows. Therefore, it is recommended that only the 
experienced user (i.e., one familiar with the prompting sequence of stArt) attempt 
to modify file INPUTS, followed by the command 

(prelude inputs) 

All others should type the command 

(prelude) 

and provide inputs to PRELUDE directly from the screen. 
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6.4. Tailoring the LAURA Algorithm 

For most applications, the necessary tailoring of the LAURA algorithm for a given case can 
be accomplished through PRELUDE. As mentioned earlier, however, PRELUDE may not provide 
sufficient tailoring of LAURA for some advanced applications. For such instances, there are 
several ways to further specialize the LAURA algorithm (without altering the $H0ME/LAURA.4. 1 
files); these methods are to 


• Create LOCAL versions of the include files created bv stArt (.strt suffixes) using the 
LOCALIZE command (appendix K) 

• Create LOCAL versions of the LAURA source files located in $H0ME/LAURA.4. 1 by using 
the LOCALIZE command (appendix K) 

• Create LOCAL pure-FORTRAN versions of source files (section K.3) by using the LOCALIZE 
command (appendix K) 

• Create CUSTOM files from LOCAL versions of source files by using the CUSTOMIZE command 
(appendix H) 


These approaches are discussed below. 

A number of LAURA's FORTRAN parameters are automatically assigned values by stArt, 
without user input, and are written to files with a .strt suffix. Any of these parameters can 
be changed by modifying a LOCAL copy of the appropriate lfn file, which is created using the 
command 

(LOCALIZE lfi^ 

For example, stArt defaults to first-order extrapolations at the body surface and outflow bound- 
aries. To switch from first to second order (via parameter nord.br in file nordbc_assn . strt ). 
type the command 

(LOCALIZE nordbc^assn. strt^ 


and a copy of file nordbc^assn . strt will be created in the working directory (appendix K ). Now 
edit the LOCAL file, and change u nordbc = V' to u nordbr — 2’\ When make is executed, this LOCAL 
file will be used in lieu of the STRTf iles version. Moreover, in future runs of PRELUDE within 
this working directory, the user will be given the option to save this LOCAL file or to overwrite it 
with the file created by stArt. 

In other cases, FORTRAN coding can be added to, deleted from, or modified in the LAURA 
source files. Tailoring these LAURA source files ( . F, .FOR, arid . inc suffixes) is done in the same 
manner as above: simply use the LOCALIZE command on a given file from the $H0ME/LAURA.4. 1 
directory and gain the desired modifications to this LOCAL file before compilation. 

Pure-FORTRAN versions ( . f suffixes) of the baseline subroutine files ( .F suffixes) can be created 
by the command 


(make fortran) 


This command first creates the directory FORTRAN (if it does not already exist), and then prepro- 
cesses each of the subroutine files (from the $H0ME/LAURA.4. 1, CUSTOM, or LOCAL directories). 
Each of the preprocessed files is placed in the FORTRAN directory (with a .f suffix instead of a 
. F or .FOR suffix). As before, tailoring of these files is accommodated through the LOCALIZE 
command; this is followed by modification of the resultant LOCAL file. 

The CUSTOMIZE command allows a LOCAL file in one working directory to be used for any 
LAURA application (without having to be present in that LOCAL directory) in lieu of the 
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$HOME/LAURA . 4 . 1 file. A CUSTOM version of the file lfn is created in the following manner. 
After making the modifications to LOCAL version of lfn, type the command 

(CUSTOMIZE lfn~) 

The file will be moved to subdirectory CUSTOM in directory $H0ME/LAURA.4. 1 (appendix H). 
future exec utions of make from any directory will use this customized version of If n in lieu of 
the original LAURA coding. 

NOTE: Jo defeat this customization in a given working directory, simply copy the 
baseline version of lfn from SH0ME/LAURA.4. 1 before executing make. This LOCAL 
copy of the baseline lfn will be used instead of the customized version. 

The command 

(XCUSTOM lfn) 

deletes the CUSTOM version of lfn (appendix N). 

NOTE: Do not use CUSTOMIZE on LOCAL versions of files created by stArt ( .strt 
suffix ). 
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Chapter 7 

Menus of stArt 


In this sort ion, the various menus of stArt are presented and annotated. The menus are 
presented in their order of appearance during stArt. Each menu is enclosed within a shaded 
box to mimic what the user will see on the computer screen. The default value for each variable, 
which reflects the choice from the last. PRELUDE session, is also shown. 

NOTE: The user can enter a comma at any prompt to accept the default 

value. 


7.1. Number of Processors 


For ( RAY architectures, the upper limit of processors that will be used during this LAURA 
run is specified through the variable nprocs : 


Enter the upper limit of processors to be used during this LAURA run. 
Enter choice (1 <= nprocs <= nprocrnx) {default}: 


where nprocmx is the number of available processors on this machine, as determined by mAch+prOc 
(appendix C, section C.‘2). 

NOTE: On CRAY machines, a single processor {nprocs = 1) should be used for 
LAURA runs where grid adjustments will be made. (See NOTE in section 11.5.:}.) 

This is required because the multiprocessing is asynchronous. 


7.2. Type of Initial Grid and Solution 


The user has a number of options for automatic generation of a surface and volume grid, 
including an initialized solution (section 9.1.1), for specific parameterized body shapes. Alter- 
nately, the user ran supply an externally generated restart file to LAURA (section 9.1.1). The 
type of initial grid and solution is specified through ncwjob ( screen 6): 
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> 

Select initialization: 

0) use existing "RESTART . in" file, 

1) create conic (cone/wedge, paraboloid, etc.), 

2) create generic aerobrake 

(includes AFE without axis singularity). 

Enter choice {default}: 

' 


Screen (5. 

NOTE: When new job - 0 is selected, stArt will issue a warning; if file RESTART . in 
does not exist in the LOCAL directory. Since stArt itself does not use this file, the 
user can continue with this PRELUDE session and create RESTART, in afterwards. The 
message simply serves as a reminder that RESTART, in must exist before executing 

laura. 

7.3. Flow Dimensionality 

The flow dimensionality is specified through ndini (screen 7): 


— > 

Select flow dimensionality: 

1) axisymmetric flow, 

2) two-dimensional flow, 

3) three-dimensional flow. 

Enter choice {default}: 


Screen 7. 


7.4. Governing Equations 

LAURA provides inviscid and viscous flow options. The viscous flow options include thin- 
layer and full Navier-Stokes equations (which require more memory for treatment of the cross 
derivatives and associated metrics). Select the governing equations through irjovrrn (screen X): 
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Select governing equations: 

0) inviscid flow, 

1) thin-layer Navier-Stokes , 

2) full Navier-Stokes. 

Enter choice {default}: 


Screen 8. 

The t li in -lave i option includes only the viscous terms defined by gradients in the coordinate 
directions emanating from wall boundaries. The viscous directions are set automatically as 
boundary conditions and are input with the variables ivin nblk , jvis nilt , and kvis nilt equal to 0 for 
off and 1 for on in computational block nblk (section 9.1.3. 1). The user can change the default 
values in the file data (which is created by stArt). 

NOTE: II igovcrn = 1 . defining ivis = jins = kins = 1 for a given block still omits the 
cross derivative terms from the full Navier-Stokes equations. The' user must specify 
igovcrn = 2 in stArt to include the full Navier-Stokes terms in the compilation of 
laura. 

7.5. Free-stream Conditions 

tutor the free-strea.ni conditions (screen 9) (in mkgs units): 


~ — >1 

Enter velocity [m/s] {default}: 

Enter density [kg/m" 3] {default}: 

Enter freestream temperature [K] {default}: 

> 


Screen 9. 
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For two- or three-dimensional flow, the angle of attack (attack) must he specified (screen 10): 




Enter angle of attack [deg] {default}: 




-j 


Screen 10. 


T.6. Surface Boundary Conditions 

The surface boundary conditions are set internally for the momentum and global continuity 
equations. 

NOTE: For nonequilibrium flows (where the global continuity equation is not solved 
explicitly ), the wall catalysis must be chosen to define the surface boundary condi- 
tions for the species continuity equations (section 7. 7. 2. 3). 

NOTE: The inviscid boundary conditions are crude; they extrapolate pressure, 

temperature, and tangential velocity components to the wall and reflect a normal 
velocity component. 

For viscous flow (* govern ^ 0), a wall boundary condition on the energy equation must be 
specified. Prescribe this wall temperature boundary condition through ternpbc (screen 11): 


f — > 

Select wall temperature BC : 

0) constant 

1) specified variation (nrfim ^ 3) 

2) radiative equilibrium 

Enter choice {default}: 

< J 


Screen 11. 

The follow-up prompts for ternpbc - 0, 1, and 2 are discussed in sections 7.6.1, 7.6.2, and 7.6. A, 
respectively. 


7.6.1. Constant Wall Temperature 

When ternpbc = 0, input the wall temperature (screen 12), as follows: 
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Enter wall temperature [K] {default}: 


Screen 12. 

7.6.2. Specified Wall Temperature Variation 

When teinpbc — 1. the wall temperature distribution is provided in file variabletw. This 
allows the surface temperature to be specified by a fixed distribution (from experimental data, 
for example). J he entries in file variabletw are the streamwise surface distance (in units) and 
temperature (K) for each location. They are read in free format (one entry per line) by stArt 
(and later by LAI HA). In reload. F, these discrete values are linearly interpolated to provide 
values at cell face centers along the surface. 

NOTE: If file variabletw is not found by stArt, the free-stream temperature is 
used to initialize the flow field temperature distribution. This "fix" allows this stArt 
session to continue, but the initial temperature distribution is less than ideal. As 
a result, the user is strongly urged to create the file variabletw and repeat the 
start-up procedure using the command 

(prelude inputs) 


NOTE: rho specified wall temperature variation (tcmpbr — 1) option is currently 
not available for three-dimensional flows. 


7.6.3. Radiative Equilibrium Wall Temperature 

When teinpbc = 2, an initial guess for the wall temperature must be supplied, along with 
the relaxation factor, ept (screen 13): 


Enter initial wall temperature [K] {default}: 


Enter wall-temperature relaxation factor {default}: 


Screen 13. 

A value of ept < 1 is an under-relaxation (with ept = 0 fixing T w at the input value) and 
ept — 1 is a straight substitution. In the early stages of convergence, it is advisable to keep 
ept = (9(0.01). This value can be increased (in file data) as the equilibrium value of T w is 
approached. 




7.7. Gas Model 


LAURA has perfect gas, equilibrium, and nonequilibrium flow capabilities for air. Define 
the nature of the gas through ngas (screen 14): 


/ ^ 

Select the gas model : 

0) perfect gas, 

1) equilibrium, 

2) chemical nonequi librium . 

Enter choice {default}: 

< S 


Screen 14. 

If ngas = 0 is specified, no other user input is required for the gas model. 

NOTE: The perfect gas is assumed to be air, but constants appropriate for other 
gases can be specified in the include files gas_model_vars . strt and sthrlnd.vars . strt. 

Subsequent screen prompts for equilibrium and nonequilibrium gas model are discussed in sec- 
tions 7.7.1 and 7.7.2. respectively. 

7.7. 1. Equilibrium 

For equilibrium flow ( ngas = 1 ), choose which t hermodynamic curve fit to use through icrv 
(screen 15): 


r > 

Select a thermodynamic curve fit: 

1) Vinokur, 

2) Tannehill. 

Enter choice {default}: 

S J 


Screen 15. 

Details of these curve-fits can be found in references 19 and 20, respectively. 

7.7.2. Nonequilibrium 

For nonequilibrium flows, the thermal state, constituent species, and wall catalysis must be 
specified. These constraints are discussed in the subsections that follow. 
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7. 7. 2.1. Thermal State 


For lionequilibrium flow ( ngas = 2), choose the thermal state of the gas through itherni 
(screen 16): 


/ \ 

Select the thermal state of the gas: 

1) equilibrium (one-temperature), 

2) nonequilibrium (two-temperature). 

Enter choice {default}: 

V J 


Screen 16. 


7. 7. 2. 2. Constituent Species 

Next, select which species will be included in the air model (screen 17): 


/ \ 

Will atomic nitrogen be considered? (y/n) {default}: 

Will atomic oxygen be considered? (y/n) {default}: 

Will molecular nitrogen be considered? (y/n) {default}: 

Will molecular oxygen be considered? (y/n) {default}: 

Will nitric oxide be considered? (y/n) {default}: 

Will ionized atomic nitrogen be considered? (y/n) {default}: 

Will ionized atomic oxygen be considered? (y/n) {default}: 

Will ionized molecular nitrogen be considered? (y/n) {default}: 

Will ionized molecular oxygen be considered? (y/n) {default}: 

Will ionized nitric oxide be considered? (y/n) {default}: 

\ > 


Screen 17. 

An answer of “y” activates the species, while an answer of ; ‘n” deactivates it. Thus, any subset 
of the total 11 species for air (N, (), N- 2 , O 2 , NO. N + , 0 + . N+, Oj" , NO + , e~ ) can be specified. 
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7. 7. 2. 3. Wall Catalysis 


Physical models within LAURA are appropriate for weak ionization. Free-stream mass 
fractions appropriate for undissociated, low-temperature air are set in block data file air .F and 
can be adjusted as required. The catalysis of the wall is defined through the variable jtyjx 
(screen 18): 


/ \ 

Select the catalytic nature of the wall boundary: 

0) non-catalytic; 

1) "super-catalytic 1 '; 

2) catalytic to ions, non-catalytic to neutrals; 

3) catalytic to ions, Stewart's f inite-catalysis ; 

4) catalytic to ions, Zoby's finite-catalysis; 

8) catalytic to ions, Scott's finite-catalysis; 

6) catalytic to ions, homogeneous recombination of all atoms. 

Enter choice {default} : 

< > 


Screen 18. 

As shown, options for noncatalytic, finite-catalytic, and “super-catalytic* wall conditions are 
available. 

NOTE: The super-catalytic condition (jtype — 1) sets the mass fractions at the 
wall to their free-stream values. This should not be confused with a fully catalytic 
condition where the surface mass fractions are defined by the equilibrium composition 
at the given wall temperature. 

Details of the jtype = 3, 4, and 5 options can be found in references 21, 22, and 23, respectively. 

NOTE: In theory, for inviscid flow, an extrapolation of the near-wall mass fractions 
to the wall provides the proper catalytic nature of this boundary. In the absence 
of this option, selecting the noncatalytic boundary condition (jtype = 0 ) is the best 
choice. 


7.8. Turbulence 

Algebraic models are employed within LAURA to provide a turbulence capability for perfect 
gas, equilibrium, and nonequilibrium flows. Control this option through nturb (screen 19): 
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Select laminar flow or turbulence model : 

0) laminar flow, 

1) Cebeci-Smith, 

2) Baldwin-Lomax 

Enter choice {default}: 


Screen 19. 

Details of the Cebeci-Smith and Baldwin- Lomax algebraic models can be found in references 21 
and 2f), respectively. 

NOTE: A well-defined boundary-layer edge is required before these algebraic models 
can be implemented. I bus. for a. given case, a. laminar-flow solution is necessary as a 
starter for turbulent flow. The laminar solution does not need to be fully converged, 
but the shock layer should be well-developed. 

NOTE: A value of 0.9 is assumed for the turbulent Prandtl number. For nonequi- 
librium flows, a turbulent Schmidt number is required as well, and a. value of unity 
is used. 

Specification of transition is discussed in section 9.1.4. 

7.9. Flow Field Grid and Initialization 

LAURA has an internal grid generation and initialization algorithm that provides the user 
with a self -starting capability. This feature is limited to select bodies that can be described 
analytically. However, LAURA will accept, externally generated grids and flow field initializa- 
tions. This option allows computations over arbitrary bodies and the use of more sophisticated 
gndding techniques. Use of such external grids is discussed in section 7 . 9 . 1 . Self-starting grids 
are the topic of section 7.9.2. 

7.9.1. Externally Generated Grid and Initialized Flow 

When newjob = 0 is specified, the user must supply the file RESTART, in for laura. The 
format ol this restart file is given in section 9.1.1. This file does not need to exist before running 
PRELUDE, but it must be present before executing laura. Required inputs for an externally 
generated RESTART, in are discussed in the subsections below. 

In laura. the grid must be oriented such that y = 0 defines the plane of symmetry. In 
the assumed orientation, the r-axis originates at the vehicle nose and is directed toward (lie 
oncoming flow (as shown in fig. 2.1 ). Such an orientation is common for blunt-body applications. 
The angles of attack and yaw are referenced to the negative --axis, which yields the following 
definitions for the free-streani velocity components: 
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tiinf - sin (attack) * cos( yaw) 
vinf = sin {yaw) 

winf = —cos (attack) * cos (yaw) 


NOTE: In laura. the yaw angle is set to yaw = 0. 

The user will probably encounter externally generated grids with other orientations. In such 
cases, it is recommended that the user re-orient the grid to conform to the examples shown in 
figures 2.1 and 2.2. Afterwards, the utility INITIALIZE can be used to initialize the flow field 
and create the LAURA RESTART, in file (appendix I). 

If the user prefers not to re-orient the grid, then the definitions of the free-stream velocity 
components can be modified. This approach involves creating LOCAL versions of files setup. F 
and flowinit.f with the LOCALIZE utility (appendix K). The appropriate modifications to the 
definitions of win}, vinf. and winf can be made in these LOCAL files. When the utility INITIALIZE 
is executed, it will detect the LOCAL version of flowinit.f, compile it. and use the resultant 
LOCAL f lOwInlt executable to initialize the given PL0T3D grid file. 

NOTE: The laura executable must be recompiled to get the new definitions from 
the LOCAL setup. F. 

Alternately, the user can employ the default definitions for the free-stream velocity compo- 
nents in conjunction with other grid orientations as long as the angle of attack is referenced to 
the negative c-axis. Consequently, a value of attack = 0 in the default orientation can correspond 
to a. value of -90. 90, or ISO deg (specified in file ■■data”) for this alternative orientation. 

7.9. 1.1. Number of Computational Blocks 

The flow field domain can be divided into multiple computational blocks. The number of 
blocks is defined t hrough the variable nblocks : 

* 

Input the number of computational blocks ( 1 nblocks 6 ) {default} 




■\ 




7. 9. 1.2. Dimensions for Blocks 

For each block nblk ( 1 < nblk < nblocks), input the variables iblk^uk, jblk nlUl (3-1) only), and 
kblk nUk , which define the number of computational cells in this block (screen 20): 
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For block nblk, input the number of cells . . . 


r 




... in the indirection {default}: 

... in the j-direction {default}: (3-1) flow only) 

... in the k-direction {default}: 

s > 


Screen 20. 

NOTE: In each direction, t he number of cells is one less than the number ol grid 
points (cell walls). 

7. 9. 1.3. Boundary Condition Types for Block Faces 

If nnvjoh = 0, the boundary type (such as a, solid surface or a free stream) of the faces of 
each block must be specified by the user. The boundary type for each of the six sides of a given 
block is defined through the variable itype (screen 21): 




Select the nature of the i = 1 boundary in block nblk: 


Select the nature of the i = iblk nbik boundary in block nblk : 


Select the nature of the j = 1 boundary in block nblk: 


Select the nature of the j = jblk Jlb i k boundary in block nblk: 


Select the nature of the k = 1 boundary in block nblk: 


Select the nature of the k = kblk nb i k boundary in block nblk: 

0) solid surface, 

1) outflow, 

2) symmetry across y = 0 plane (3-D flow), 

3) freestream, 

4) symmetry across x = 0 plane (axisymmetric or 2-D flow), 

5) symmetry across y = 0 plane (axisymmetric or 2-D flow) , 
7) axis (for 3-D flow), 

9) boundary shared with another block. 


Enter choice {default}: 


Screen 21. 


NOTE: For brevity, the option list is shown on the k = kblk nhlk screen only. 

If a shared boundary is specified, the block with which the boundary is common must be speci- 
fied: 


Enter the number of that block {default}: 



NOTE: If new job 7 ^ 0. a single block is created, and default values for the boundary 
types of the faces of this block are defined automatically. No user specification is 
required. 
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7.9.2. Self-Starting Grid and Flow Initialization 

When new job ± 0, stArt generates the RESTART, in file. Required user inputs for this option 
are discussed in the subsections that follow. 

7. 9. 2.1. Number of Computational Blocks 

The geometry and flow field grids are generated by using a single computational block, which 
is based on user inputs that are discussed later. 

7. 9. 2. 2. Dimensions for Computational Block 

First, the size of the grid is defined through iaq, jaq (3-1) only), and kaq (screen 22): 


( > 

Input iaq, the number of cells in the streamwise direction 
along the body. 

Enter choice (1 <= iaq <= niqm) {default}: 

Input jaq, the number of cells in the circumferential direction 
around the body. 

Enter choice (1 <= jaq <= jaqm ) {default}: (3-1) flow only) 

Input kaq, the maximum number of cells normal to the body. 

Enter choice (1 <= kaq <= kaqm) {default}: 

V > 


Screen 22. 

where iaqm = 200, jaqrn = 100. and kaqm = 128. 

NOTE: If these values are too restrictive, the user can create a LOCAL copy of the file 
start, inc (using the LOCALIZE corn in and) and modify these limits. When PRELUDE 
is executed, this LOCAL file will be used to create a LOCAL stArt executable, which is 
then used by PRELUDE in lieu of the default executable. PRELUDE accommodates LOCAL 
copies of any of the stArt source files (located in the $H0ME/LAURA . 4 . 1 directory), 
if the user desires to modify stArt to produce tailored case-specific include files 
( . strt suffixes). 

A single computational block (Block A) is utilized, where iblk\ — iaq , jblk { — jaq , and kblk\ = kaq. 
For two-dimensional and axisymrnetric flows, jhlk x — 1. 

If options for grid adaption and alignment with the captured bow shock are to be exercised, 
then kblk\ must be the number of cells between the body and the free- stream inflow boundary. 
Furt hermore, kblk\ should be divisible by 1 if options for coarse-grid initialization of the solution 




are implemented, as is the case when any of the self-start geometry initialization packages are 
employed. 

NOTE: For new job — 2 and ndirn — 3, the number of circumferential cells (jaq) is 
defined as one-half of the number of streamwise cells (iaq). If the input value for inq 
is not a multiple of 2, it is overwritten to iaq — 2 X jaq . The resultant values of iaq 
and jaq are then echoed to the screen. 

7.10. Geometry Definition 

LAURA is written using mkgs units. However, other units of length can be accommodated 
through the conversion factor rflngth. The value of rflngth (and hence, units) for several common 
choices is controlled through iunit (screen 23): 


( \ 

Select units for the geometry: 

0) meters, 

1) centimeters, 

2) feet, 

3) inches, 

4) other units . 

Enter choice {default}: 

\ J 


Screen 23. 

If iunit ^ 4, the conversion factor from grid units to meters ( rflngth) is automatically loaded. 
For instance, if the surface geometry and volume grid are defined in inches, then units = in. and 
rflngth = 0.0254 (since 1 in. — 0.0254 m). 

For iunit — 4, the user must explicitly define units and rflngth (screen 24): 
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Enter 1- or 2-character abbreviation for this custom unit 
of length {default}: 

The conversion factor "rflngth" is defined such that: 

1 units = "rflngth" meters 
Enter "rflngth" {default}: 

J 


Screen 24. 

This feat ure allows t he user to define a volume grid based on a nonst andard met ric. For example, 
a generic blunted-cone might be defined in units of nose radius ( R \). If R \ = 2 ft and the 
volume grid was created in units of nose radius, then units = RN and rflngth = 0.609b (since 
1 RN = 2 ft = 0.6096 m). Proper specification of this factor is important because it is used to 
defi ne the Reynolds number per unit grid length in the solution. 

Required geometry inputs for externally supplied grids are described in section 7.10.1. Self- 
starting conic geometries (such as cones, paraboloids, and hyperboloids) are discussed in sec- 
tion i . 10 . 2 . Self-starting aerobrakes (such as the Aeroassist Flight Experiment (AFE) and 
spheres) are the focus of section 7.10.4. 

7.10.1. Externally Generated Grid 

When nrwjob — 0, the volume grid (and initial flow field) must he provided by the user. 
Section li.i gives restrictions on the grid orientation for two-dimensional and axisymmetric 
flows. 


NOTE: The self-starting feature of LAURA can be employed to produce grids for 
flows over simple analytic shapes (section 7.10.2). 

Several metrics of the geometry must be supplied by the user when the newjob = 0 option is 
chosen. 1 he variables xcg and zcg define the location of the reference center for aerodynamic 
moments in grid coordinates (screen 25): 


^ 

Enter x-coordinate of moment center [units] {default}: 

Enter z-coordinate of moment center [units] {default}: 

> 


Screen 25. 
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NOTE: It is implicitly assumed that the flow has y — 0 as its plane of symmetry 
with ycg = 0. 

The variables ref area and re fieri define the reference area and length, respectively, for the eval- 
uation of aerodynamic coefficients (screen 26): 


/ \ 

Enter reference area for aerodynamics [units'* 2] {default}: 

Enter reference length for aerodynamics [units] {default}: 

S / 


Screen 26. 


NOTE: For self-starting grids ( new job 0), the values of xcg. zeg , ref area , and 

nflen are defined by stArt (along with ycg — 0). The user can change these values 
in file data. 

7.10.2. Self-Starting Grid (Conic Geometry) 

When newjob = 1 , the conic geometry must be defined through a series of user inputs. 
Based on these values, xcg. zcg , re fare a, and re fie n are loaded by stArt (along with ycg = 0). 
For ndini < 3 (axisymmetric or two-dimensional flow), the body dimensionality is equal to the 
flow dimensionality (ndimb — ndirn). If ndim — 3, then the dimensionality of the body must be 
specified through the variable ndimb (screen 27): 


Select body dimensionality: 

1) axisymmetric, 

3) 3-D. 

Enter choice {default}: 


J 


Screen 27. 


NOTE: The option of ndimb = 2 is eliminated in this case because the configuration 
cannot be two-dimensional when ndirn = 3. 

The type of conic section is prescribed through the variable Iconic. The options for konic are a 
function of ndimb. The next three sections show the options for Iconic based on the value of the 
body dimensionality (ndimb). 
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7.10.2.1. Axisymmetric Geometry 


For ndimh — 1. the options for konic (screen 28) are: 


— — . 

Select axisymmetric body: 

1) hyperboloid, 

2) paraboloid, 

3) ellipsoidally-blunted cone, 

4) spherically-blunted cone. 

Enter choice {default}: 

V > 


Screen 28. 

For konic > 2, the value of ic must he specified (screen 29): 


f "v 

Input the number of cells (axial direction) to be used on the cap. 

Enter choice (2 <= ic <= iaq) {default}: 

< J 


Screen 29. 

Unless konic = *2. the variable 0 must he specified. For konic = 1 . this is the half-angle of 
the asymptote of the hyperboloid: 


/ \ 

Enter half-angle [deg] of asymptote {default}: 

< > 


For konic = 3 and konic = 4, 0 is the body half- angle: 




Enter body half-angle [deg] {default}: 

V > 


For konic = 3. the axial shape parameter of the nose ( b ), wliich is a function of the eccen- 
tricity. must be defined (appendix 13): 
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Enter axial shape parameter for nose, b 
( b > 0, where b = 1 is circle ) {default}: 


NOTE: For konic — 4, b = 1 automatically. 

The next step is to specify the nose radius and total body length of the geometry: 


/ \ 

Enter nose radius [units] {default}: 

Enter body length [units] {default}: 

S, > 


7. 10.2.2. Two-Dimensional Geometry 

For ndirnb = 2 (only possible for ndim =2), the options for konic are: 


/ \ 

Select 2-D body: 

1) hyperbola, 

2) parabola, 

3) blunted wedge. 

Enter choice {default}: 

< J 


For konic = 3, the value of ic must be specified: 


/ \ 

Input the number of cells (axial direction) to be used on the cap. 

Enter choice (2 <= ic <= taq) {default}: 

< > 


For konic = 1 or konic — 3, the variable 0 must be specified. For konic — 1, this is the 
half-angle of the asymptote of the hyperbola: 


\ 

Enter halt-angle [deg] of asymptote {default}: 

< > 


38 











For Iconic = 3, 0 is the body half-angle, and must be specified. Also for Iconic = 3, the axial 
shape parameter for the nose (b) must be defined (appendix B): 


Enter body half -angle [deg] {default}: 


Enter axial shape parameter for nose, b 
( b > 0, where b = 1 is circle ) {default}: 

V- > 


The next step is to specify the nose radius and total body length of the geometry: 


( 

Enter nose radius [units] {default}: 

Enter body length [units] {default}: 

V > 


7.10.2.3. Three-Dimensional Geometry 

For ndimb — 3, the options for konic are as follows: 


/ — \ 

Select 3-D body: 

1) hyperboloid, 

2) paraboloid, 

3) blunted cone. 

Enter choice {default}: 

\ > 


For konic — 3, the value of ic must be specified: 


v 

Input the number of cells (axial direction) to be used on the cap. 

Enter choice (2 <= ic <= taq) {default}: 

* 


Unless konic — 2. the variable 0 must be specified. For Iconic = 1. this is the half-angle of 
the asymptote of the hyperboloid: 
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Enter half-angle [deg] of side-plane asymptote {default}: 

S 


For konic — 3, 0 is the body half-angle, and must be specified. Also lor konic — 3, the axial 
shape parameter for the nose (b) must be defined (appendix B): 


f > 

Enter body half -angle [deg] in side plane {default}: 

Enter axial shape parameter for nose, b, in side plane. 

( b > 0, where b = 1 is sphere ) {default}: 

< J 


The next step is to specify the nose radii, in both the symmetry and side planes, along with 
the total body length of the geometry: 

r > 

Enter nose radius [units] in side plane {default}: 

Enter nose radius [units] in symmetry plane {default}: 

Enter body length [units] {default}: 

< J 


7.10,2,4. Axial Stretching Factor 

As a final step for konic > 3 (for all values of ndimb ), the axial stretching factor (axfac) for 
the grid must be defined. A message to the screen provides the user with the minimum value of 
axfac required to reach the end of the geometry, based on the previously specified values for u\ 
iaq , and zmax. This value is the default answer to the following prompt: 


— > 

Enter axial stretching factor {default}: 

< 


A value of axfac - 1 yields no axial stretching. To prevent overstretching, values larger than 
approximately axfac =1.2 should not be used. 
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7.10.3. Self-Starting Grid (Generic Aerobrake) 

When nrwjob = 2, the aerobrake geometry must be defined through a series of user inputs. 
Based on these values, xry, zcy , rtf aim , and rrflfu are loaded by stArt (along with ycg = 0). 
l irst . the type of aerobrake geometry is selected t hrough variable iafc 




a 

Select aerobrake geometry option: 


0) AFE aerobrake, 

1) hemisphere, 

2) customized aerobrake. 


Enter choice {default}: 



J 

7.10.3.1. AFE Aerobrake 


When iafc = 0, the aerobrake parameters are automatically set to the Al 
(ref. 2(j) values. 

FT] configuration 

NOTE: Because the AF F, geometry is three-dimensional, a specification 
can only be made if ndim — 3. 

o 

II 

7.10.3.2. Hemisphere 


When iafc — 1. the nose radius must be specified (in meters): 



\ 

Enter radius [m] {default}: 


V 

J 


7.10.3.3. Customized Aerobrake 

When iaft = 2. the parameters that are defined implicitly for iafr = () must, be explicitly 
supplied by the user (screen 30). 

NOTE: Accepting the echoed default values will yield the AFE geometry. 

A graphical representation of a typical body in the plane of symmetry, including explanations 
of the various parameters, is provided in figure 7.1. 


41 




Enter body hall-angle [deg] in symmetry plane {default}: 

Enter rake angle [deg] of base plane relative to body axis 

(enter "90" for axisymmetric body) {default}: (3-D flow only) 

Enter turning angle [deg] of shoulder 
(usually same as body half-angle) {default}: 

Enter shoulder radius [units] {default}: 

Enter eccentricity of nose {default}: (3-D flow only) 


Enter nose radius [units] of blunted cone in symmetry plane {default}: 


Enter base plane radius [units] {default}: 


Screen 30. 


6 body half-angle 

8 rake angle 

x turning angle 

e nose eccentricity, b/a 


R Sh shoulder radius 
R n nose radius 
R b base plane radius 



B 


Figure 7.1. Parameters for defining generic probe shape in LAURA. 
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Chapter 8 


Compiling LAURA 


In an effort to minimize computer memory requirements, LAURA makes extensive use of 
include statements that allow the code to be tailored to a. given application. This tailoring is 
facilitated through the execution of stArt. a preprocessor for LAURA, which is used to define 
array dimensions, governing equations, and gas models according to user inputs. Additional 
customizat ion is possible t hrough direct file editing. In the past, this meant that a local copy of 
the complete LAURA code needed to be present before compilation. This arrangement left the 
working directories cluttered with source files (many of which had undergone no modification) 
and object files. As a result, keeping track of the changes in the source files from case to case 
was a cumbersome task. 

LAURA is based on the premise that the bulk of the LAURA source code does not change 
from one applicat ion to the next. These files, which should rarely require modification, are kept in 
a read-only directory. The relationship between (and roles of) the various directories employed by 
LAURA is shown in figure 2.3. Through stArt, the user defines parameters, compile directives, 
and other quantities that communicate the user's instructions to the $HOME/LAURA .4 . 1 files 
during compilation. The capabilities of stArt have been expanded, and as a result, the need 
for direct editing of LAURA source files has been minimized (eliminated, in fact, for many 
applications). 

For the most part, the tailoring is controlled through the files produced by executing stArt 
(denoted by .strt suffixes). To reduce clutter in the working (LOCAL) directory, subdirectories 
are created by PRELUDE (fig. 2.3). The files produced by stArt are stored in subdirectory 
STRTfiles, while OBJfiles holds the object files produced during compilation. 

Should a LAURA file (.F, .FOR, .inc, or .strt suffix) require further tailoring, a LOCAL 
copy (lfn) is created with the command 

(LOCALIZE lfn) 


and then edited. 

NOTE: All tailoring of LAURA should be performed in the working (LOCAL) di- 
rectory, thus allowing the installed version to remain intact. 

A pure-FORTRAN version ( .f suffix) of a subroutine file ( .F or .FOR suffix) is also acceptable. A 
subsequent compilation uses this LOCAL file in lieu of the $HOME/LAURA . 4 . 1 version. 

NOTE: The LOCAL directory should contain no files with a .f, .F, .FOR. .inc, 

or .strt suffix which are not LAURA source files. Otherwise, extraneous warning 
messages may be displayed on the screen when make is executed. 
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T he command 


(CUSTOMIZE lf^T) 

moves a LOCAL file ( .F. .FOR, .f, or . inc suffix only) to directory CUSTOM in $HOME/LAURA . 4 . 1. 
and makes it the default instead of the $HOME/LAURA .4 . 1 version. 


8.1. Using make 

When the command 

(make) 

is executed, the actual compilation takes place in subdirectory OBJfiles. 

NOTE: On some machines, the environment variable $H0ME is not exported to 

make. In such cases, the command 

(make H0ME=$H0 Me] 

is required to provide make with the value of $H0ME. 

This fairly sophisticated Makefile is created by stArt. which tailors it not only to the machine 
architecture, but also to the specific case being run. For instance, if perfect gas flow is specified, 
the nonequilibrium and equilibrium gas routines are not included in the compilation. In fact, 
the stArt inputs of i govern , machine, ndim , ngas , and nturb determine which source files make 
is dependent upon. I his treatment yields further reductions in computer memory requirements. 
Since this Makefile does more than simply compile the code, the various steps (appendix E. 
section E.l) are discussed below. 

First, the script SYMLINKS (appendix E, section E.‘2) is executed to tell make where to find 
the source files it needs. Initially, symbolic links are established for the files in $HOME/LAURA . 4. 1 
and STRTf iles. These symbolic links are redefined to the LOCAL and CUSTOM directories for any 
files that exist there. In other words, LOCAL and CUSTOM files are used if they exist; otherwise, 
the files in $H0ME/LAURA.4. 1 and STRTf iles are used. 

NOTE: If make has been executed previously, a. check of these subdirectories is 
conducted to see that all LOCAL and CUSTOM files used in that compilation still exist. 

If not. the appropriate object files are removed before compilation so that the new 
executable reflects this change. 

Next, the script Makedep (appendix E, section E.4) is executed to establish the dependencies 
of ea< h subroutine file ( .F, .FOR. or .f suffix) on the include files. For each source file. Makedep 
determines which include files ( . inc and .strt suffixes) it depends upon. These dependencies 
are saved in file CHILDREN, which is in the OBJfiles directory. The existence of this file allows 
make to recognize when an include file is newer than an object file whose source file depends 
upon it. W hen this is the case, the source file is recompiled. 

Now that make knows which source files it needs, and in turn, which include files they each 
depend upon, the actual compilation begins. More exactly, each subroutine file (.F, .FOR, or 
.f suffix) is first preprocessed according to the compile directives supplied by stArt. After 
preprocessing, the file is compiled, and the object ( .o suffix) file is saved in OBJfiles. When all 
of the object files have been created, they are linked to create laura, the LAURA executable. 
Although this executable resides in OBJfiles, it is symbolically linked to the LOCAL directory 
to facilitate its execution. 

The final step performed by make is the removal of the symbolic links located in OBJfiles. 
This step serves to reduce clutter in the OBJfiles subdirectory. 
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8.2. Using make debug 

For running LAURA in conjunction with the dbx debugger (cdbx on (’RAY architectures), 
the code must first be compiled with the debugger option. Also, the symbolic links should be 
retained so that dbx can locate the source files. To address these needs, the command 


(make debug j 


is employed. T his command creates a subdirectory DEBUG, establishes the proper symbolic links, 
and compiles LAURA using the debugger flag (-g). Further, links are created for files data, 
RESTART, in. and TWALL.in (if it exists), which are in the LOCAL directory. For turbulent flows, 
links are also created to the LOCAL files transition and variabletw. To run the debugger, 
move down to the DEBUG directory. 


8.3. Using make fortran 

The command 

(make fortran) 

preprocesses each of the files with a .F or .FDR suffix without actually compiling and linking 
them to produce the LAURA executable. As with the standard make, symbolic links to the 
proper files are established. In addition to processing the compile directives, this command also 
pipes in the include files. Farh resultant pure-FORTRAN file (which has the root name of the . F 
file and a .f suffix) is placed in subdirectory FORTRAN. As in section 8.1, after preprocessing, the 
symbolic links are removed. 

The make fortran feature is useful for testing new code, since such new coding can be added 
to a file that is already tailored to the desired application. For example, in an equilibrium flow 
application, make fortran produces subroutine files (.f suffixes) in which the perfect gas and 
nonequilibrium flow coding has been omitted. Without these extraneous lines of FORTRAN, the 
user can more easily focus attention on the active (in this case equilibrium flow) sections of the 
various routines. Files of interest can be copied to the LOCAL directory, modified, and used in 
subsequent compilations since, as mentioned earlier, a LOCAL file with a .f suffix is recognized 
by make as a replacement for the default subroutine file ( ,F or .FOR suffix). 
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Chapter 9 


Controlling LAURA 


The LAURA input and case-specific include files ( .strt suffixes) are the files through which 
the user can most readily control the options of LAURA. Typically, in fact, except for some 
advanced applications, these are the only files that, the user should have to alter for a given case. 
These files can lx- grouped in the following two classes: 

• Control via. execution. The LOCAL mandatory files (data. RESTART, in) and application- 
dependent files ( assign_tasks. transition. TWALL.in. variabletw) are read by laura 
(the LAURA executable) at run time. Therefore, laura does not. need to be recompiled 
when these files are altered. These files are discussed in section 9.1. To run LAURA 
interactively, type the command 

(laura < data > lfn) 

1 his command sends the out put to file If n. User control of a. given run is provided t hrough 
the input files and the include fdes with the .strt suffix (chapter 9). 

• Control via compilation. Changes to the files created by stArt are communicated during 
compilation of laura. The files consist of compile directives (in HEADER, strt ) and FORTRAN 
parameter statements (in a number of files with .strt suffixes). The files are discussed 
in section 9.2. As with the LAURA source files (.F, .FOR, and .inc suffixes), it is rec- 
ommended that any changes to these files be made on a LOCAL copy (using the LOCALIZE 
command), rather than the STRTfiles version. Subsequent PRELUDE runs will preserve 
these tailored files, rather than simply overwriting them in STRTfiles. Remember, to 
reflect a change in any of these files, laura must be recompiled. 

First consider those files that, provide user control during execution. The files data and 
RESTART, in are required inputs for any LAURA run. The file data contains a set of parameters 
(free- st ream conditions included) which give the user a certain degree of control over LAURA 
without the need for recompilation. As its name implies, RESTART, in is the file that gives 
LAURA a restart capability. A third file, TWALL.in, supplies the surface temperature distribu- 
tion when the radiative equilibrium wall temperature (tempbc = 2) option is exercised. If the 
specified wall temperature variation (tempbc = 1) option is exercised, the surface distribution is 
provided through file variabletw. When turbulent flows are calculated, the onset of transition 
is supplied through file transition. The file assign.tasks can be used to control processor 
allocations to computational blocks, as well as sweeping directions. Details of these files are 
given in sections 9.1.1 through 9.1.6. Both RESTART. in and TWALL.in are binary files. The 
other input files are ASCII format and can be modified through direct editing. The contents 
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of assign-tasks, data, transition, and variabletw are echoed to standard output with each 
execution of laura. This documents which LAURA options are active for a. given run. 

Now consider those files that provide user control during compilation. In general, the safest 
way to modify a file with a .strt suffix is through PRELUDE. However, for some advanced 
applications (chapter 1 1 ), direct editing of LOCAL versions of these files (created via the LOCALIZE 
command) is necessary. Some specific recommendations for modifying these files are given in 
sections 9.2.1 through 9.2.10. 

NOTE: There is actually another option for tailoring these files with . strt suffixes. 

As mentioned in section 7.9.2, PRELUDE can accommodate LOCAL or CUSTOM copies 
of stArt source files, which in turn gives the user the ability to produce tailored 
case-dependent include files ( .strt suffixes). If any LOCAL stArt source files exist, 
PRELUDE will use them in conjunction with any CUSTOM files to create a LOCAL stArt 
executable. If CUSTOM stArt source files exist, but no LOCAL stArt source files are 
present, PRELUDE creates a CUSTOM stArt executable. This approach is especially 
useful for any modifications that will be repeated on a regular basis. This option 
is useful when changing the flow field initialization for a “cold-start solution, lor 
example. 

The contents of HEADER, strt, as well as files 

algnshk.vars . strt iupwind.assn . strt parameter . strt 

gas -model _vars . strt mtaska.assn . strt source.vars . strt 

issd.assn . strt nordbc_assn . strt sthrlnd.vars . strt 

are repeated in LOCAL file ECHOSTRT (appendix E, section E.2). This file is created bv make, 
and serves to document the LAURA options that are active for a given compilation. During 
subsequent executions of laura, the contents of ECHOSTRT are echoed to standard output. 

NOTE: The file ECHOSTRT should not be mistakenly edited in an attempt to effect 
changes to the laura executable. Modifications should be made via PRELUDE or 
through a LOCAL version of the above files, followed by a recompilation of laura. 

9.1. Control Via Execution 

9.1.1. File RESTART . in 

The LAURA restart capability requires that the binary file RESTART, in be preserved be- 
tween runs. This file is unformatted to minimize memory requirements. The file RESTART, in 
contains the grid, along with the primitive variables, for the entire flow field. As a result, in 
subsequent runs, LAURA can pick up the previous solution where it left off. The RESTART, in 
file is overwritten at the conclusion of each successful LAUR A run. 

NOTE: Files RESTART, in and TWALL.in are overwritten at. the end of each execu- 
tion of laura. A backup capability exists through the command 



(appendix J ), which simply copies RESTART, in to RESTART. backup and TWALL. in to 
TW ALL .backup. 
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LAURA always expects to find RESTART, in, even for cold starts. If ncwjob ± 0 (conic 
or aerohrake geometry) is specified when running PRELUDE, then RESTART, in is automatically 
generated by stArt. Otherwise, the user must supply an externally generated restart file for 

laura. This Hie does not need to exist before running PRELUDE, but it must be present before 
executing the command 

(laura < data) 

The flow field domain can be divided into multiple computational blocks, and this is re- 
flected in the restart file. LAURA obtains information from RESTART, in for each block. For 
nonequilibrium flow, the sequence for a given block (screen 31) is: 


read (24) ix, jx, kx , Is 


read (24) 
ft 
ft 
ft 
ft 
ft 
ft 
ft 
ft 
ft 


(( ( u(i , j ,k) 

((( v(i,j,k) 

((( w(i,j,k) 

(( ( temp(i , j ,k) 

( ( (tempv(i , j ,k) 
((( ( ri(i, j ,k,s) 


, i*l,ix ), j=l,jx 
, i=l ,ix ), j=l,jx 
, i=l , ix ), j = 1 , j x 

> ), j ~ 1 » j x 

, i-l,ix ), j^l , jx 
, i-l f ix ), j=l , jx 


), 

), 

), 

), 

), 

), 


s=l,ls ), 

((( x(i,j,k) , i=l , ix+1) , j=l,jx+l), 
((( y(i,j,k) , i=l ,ix+l) , j=l,jx+l), 
((( z(i,j,k) , i=l , ix+1) , j=l,jx+l), 


k=l ,kx ), 
k=l ,kx ) , 
k= 1 , kx ) , 
k=l ,kx ) , 
k=l,kx ), 
k=l ,kx ) , 

k=l ,kx+l ) , 
k=l ,kx+l) , 
k=l ,kx+l ) 


Screen 31. 


where ix. jx. kx are ML jblL and kblL respect ively, for block .r. and Is is the number of species. 
Further, temp is T. tempv is 7\ , and ri(s) is Ps ; u, v. and w are velocity components; and x. y. 
and z are ( artesian coordinates. This read sequence is repeated for each block. 


NOTE: for each block, laura checks the values of ix, jx. kx. and Is against 

the maximum dimensions allowed (as specified in parameter. strt). If these upper 
limits are exceeded, an error message is issued, and the job is terminated. 

for perfect gas and equilibrium flows, the sequence for a given block (screen 32) is as follows: 
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read 

(24) 

ix, 

jx, kx, Is 





read 

(24) 

((( 

u(i,j ,k) 

i=l , ix 


), k=l,kx 

), 

k 


((( 

v(i, j ,k) 

i»l ,ix 

). j-l.jx 

), k=l,kx 


& 


((( 

w(i, j,k) 

i=l , ix 

). j”l.jx 

), k=l,kx 


k 


((( 

temp(i , j ,k) 

i=l , ix 

). j-l.j* 

), k=l,kx 

), 

ft 


((( 

e(i, j ,k) 

i=l ,ix 

). 

), k=l,kx 

), 

ft 


((( 

rid , j ,k, 1) 

i=l , ix 

), j=l.jx 

), k=l,kx 

)> 

ft 


((( 

x(i , j ,k) 

i=l,ix+l), j=l,jx+l), k=l,kx+l). 

k 


((( 

y(i, j ,k) 

i=l , ix+1 ) , j=l,jx+l), k=l ,kx+l) , 

k 


((( 

z(i,j ,k) 

i=l,ix+l), j=l , jx+l) , k=l,kx+l) 


Screen 32. 

For perfect, gas and equilibrium flows, air is treated as a. single species (Is = 1 ), which is reflected 
above in the read sequence. As a result, p, = fh = P- This read sequence is repeated for each 
block. 

As mentioned above, RESTART, in is automatically generated for ncwjob f 0 (conic or aer- 
obrake geometry). This cold-start file is a function of a number of user specifications (such as 
geometry or free-stream conditions). In stArt, the flow field variables are initialized as follows 
(screen 33): 


ef actor = 8314.3 / ( bgas * wgas * vinfb**2 ) 

do 50 k=l,ka 

etal = ( k - 1. ) / ka 

do 50 j=l, ja 
do 50 i=l,ia 

u (i,j,k) * etal * uinf 

v (i, j ,k) = etal * vinf 

w (i , j ,k) = etal * winf 

temp(l , j ,k) = etal * tint + < 1. - etal ) * twall 
e (i , j ,k) = temp(i,j,k) * efactor 

50 continue 


Screen 33. 

where uinf . , vinf and winf are the u-, v-, and ^-components of the free-stream velocity, respec- 
tively, tin } is the free-stream temperature, and twall is the wall temperature. In addition to the 
above assignments, Ty = T and p s = p s ,oc initially. 

NOTE: The above quantities are normalized in the following manner. The velocities 
( m. v, uk uinf vinf and winf) are nondimensionalized by the free-stream total velocity, 
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while the internal energy (c) is divided by this quantity squared. The species densities 
( n) are normalized by the free-stream density. All temperatures are in degrees K. 
while r, y. and ~ are in grid units. 

NOTE: As seen above and mentioned earlier, the self-starting feature of stArt 

employs a single computational block with the A-direction normal to the body. 


9.1.2. File assign_tasks 

J he AS( II file assign_t;asks gives the user control over several facets (which follow) of the 
LAURA algorithm via five parameters ( nbk\ tnbk , As/r/, Istop . and inapcpu): 

• Partitioning of computational blocks 

• Number of processors assigned to individual blocks 

• Sweep direction for each block 

These five parameters, discussed in section 11.5.2, are entered on a single line in free format. A 
sample file is shown below (screen 34) for a five-block, eight -processor case: 


1 

3 

1 

20 

1 

2 

3 

1 

20 

2 

3 

3 

1 

20 

3 

4 

3 

1 

20 

4 

5 

3 

1 

20 

5 

1 

3 

21 

40 

6 

2 

3 

21 

40 

7 

3 

3 

21 

40 

8 

4 

3 

21 

40 

1 

5 

3 

21 

40 

2 

1 

3 

41 

60 

3 

2 

3 

41 

60 

4 

3 

3 

41 

60 

5 

4 

3 

41 

60 

6 

5 

3 

41 

60 

7 


Screen 34. 

Here kblk n — 00 for each block /*, with Istrt and Istop defined as shown in the third and fourth 
columns, respectively. A A*- directional sweep ( mbk = 3) is specified for all tasks in the second 
column. 

NOTE: The solution for a given block may be “frozen,” while others are advanced by 
simply omitting that block from assign_tasks. For instance, in the above example, 
if the assignments for Block C ( nbk = 3) were not included, then computations would 
be performed on the other four blocks while the Block C flow field remained fixed. 
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9.1.3. File data 


The most direct user control for a given LAURA run is through the ASCII file data, which 
contains a number of parameters. Each entry is followed by a brief comment (i.e.. variable name, 
short description, or acceptable values). LAURA receives these instructions through a series of 
free- formatted read files from data. The values for parameters that appear in data can be 
modified by the user through direct editing of the file. However, as a rule, lines should not bo 
added to, or deleted from, file data to run different cases. Rather, the PRELUDE session should 
he repeated to create a new file data. 

A sample data file is shown below (screen 35). 


1 

nord 

VERS I0N= LAURA .4 . 1 

l(st-) or 2(nd-> order spatial accuracy 

1 

ntrnsprt . 

iterations between transport property updates 

1 

njcobian . 

iterations between jacobian updates 

0 0 1 

{i, j , k}vis 

. 0=“off/l=on for {i,j,k} TL N-S viscous terms in block 1 

. 50000E+04 

vinfb . . . . 

freestream velocity [m/s] 

. 10000E-02 

rinfb . . . . 

freestream density [kg/nT3] 

.20000E+03 

tinf 

freestream temperature [K] 

0 

tempbc . . . 

.... {0=constant, l=variable, 2=radiative equilibrium} Tw 

. 50000E+03 

twall . . . . 

if tempbc”0: wall temperature [K] 

0.000 

ept 

if tempbc*2: temperature relaxation factor (0 < ept < 1) 

1.0000 

rflngth . . 

... conversion: grid units ==> meters (1 m - 1.0000 m) 

o 

o 

o 

o 

o 

o 

o 

? 

o 

o 

zcg 


0 . OOOOOOE+OO xcg 


0 . 3141S9E+01 

refarea . 

reference area of body [m "2] 

0 . 200000E+01 

ref len . . 

reference length of body [m ] 

100 

iterg . . . 

maximum iterations for this run 

20 

movegrd . 

frequency of grid adiustments 

0 

maxmoves 

maximum number of grid adiustments (0=no limit) 

1 

iabseig . 

{0=normal , l=scaled} limiter 

0.300 

epsa .... 

eigenvalue limiter 

0.010 

errd .... 

error criteria for grid doubling 

10.00 

hrs 

time limit for this run [hr] 

2.00 

rf inv . . . 

inviscid relaxation factor, (rfinv > 1.5) 

1.00 

rf vis . . . 

viscous relaxation factor, (rfvis > 0.5) 


Screen 35. 

The above file is actually the initial data file for the sample case presented in appendix A. 

The first line of data is a header that can be tailored by the user. Since this file is echoed 
in the LAURA output, the header serves as an identifier. The contents and length of (number 
of entries in) data are application-specific and thus will differ from case to case. The variable 
{frozen is only included for nonequilibrium flow. Values for ivis, jins , and kins are defined for 
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Table 9. 1 . Dependence of data on newjob 


m a job 

nord 

ntrnsprt 

njeobian 

itcrej 

movegrd 

0 ^ 

2 

20 

20 

j 9000 

0 

1. 2 

1 

J 

1 

100 

20 


each computational block. The variable attack is only included for tin 
variables tenipbe - , twall. and ept are excluded for inviscid flow (since 
the energy equation is not required). In other words, the choices for 
within stArt will determine which entries are present in data. 


•ee-dimensional flow. The 
a boundary condition for 
iit/as. whin, and igoxxrn 


NOTE: I he exclusion of inactive variables serves as a safeguard to prevent 
lrom wasting CPU time with changes that have no effect, on the solution. 


lie user 


NOTE: Any entry in file data can be modified by editing the file directly. For 

example, changes in free- stream conditions are easily made in t his manner. However, 
if a particular entry is not present in the current file data, then t he user is advised 
to rerun PRELUDE to make the changes. For example, suppose after converging a 
solution for inviscid flow, the user wishes to use that, solution to initialize a viscous 
flow. As mentioned above, the variables tenipbe, twall. and apt are not present in the 
file data lor inviscid flow, so the user should rerun PRELUDE to specify these values. 


9. 1.3.1. Initialization 

An initial version of data is produced by stArt. The following variables are defined directlv 
through user inputs: 


attack rinfb 

vinfb tin/ 


tcnipbc e pf 

twall 


The variable rflngth is supplied by stArt. based on the units specified by the user. The following 
initializations are supplied by stArt: 


i frozen = 1 
maxmoves = 0 
iabscig = 1 


epsa = 0.3 
ernl = 0.01 
hrs - 10 


rfinv = 2 
rfris = 1 


Changes to these variables must be made by editing file data. 

Based on the newjob specification, stArt makes the initializations shown in table 9 1 If 
ne wjob = 0, the user must supply the Cflt- location (xcg,zcg), reference area ( referred). and reference 
length (re fie n) for the geometry. These values are provided by stArt for newjob jt 0. Changes 
to variables listed in table 9.1 must be made by editing file data. 

'Idle parameters ivis. jvis, and kvis toggle (0 = off/1 = on) the viscous terms in the i- j- and 
Redirection, respectively. For increased flexibility, file data contains a set of these t oggles for each 
computational block. If Euler equations are specified, ivis = jvis = kvis = 0 for full Navier 
Stokes equations, ivis = jvis = kvis = 1. For thin-layer Navier-Stokes equations, viscous terms 
are included only m the body-normal direction. The self-starting feature of LAURA assumes 
the A’-direction is normal to the body and therefore sets ivis = 0, jvis = 0, and kvis = 1. The 
values of ivis. jvis , and kvis can be modified by editing file data. 




NOTE* If thin-laver Navier-Stokes equations ({govern = 1) have been specified, 
simply defining ivi* = jvis = fa* = 1 DOES NOT yield the full Navier-Stokes 
equations because the cross derivative terms are omitted. The user must specify 
{govern = 2 in stArt to activate (during compilation of laura) the full Navier-Stokes 

terms. 


NOTE: If thin-layer Navier-Stokes equations (* govern — 1) have been specified, 

setting iris = jvis = kvis = 0 yields the Euler equations. However, the boundary 
conditions are still those of viscous flow. Further, past investigations have shown 
that if a viscous solution is used as the initialization for inviscid calculations, the 
boundary layer does not completely disappear unless the grid stretching in the body- 
normal direction is redefined according to inviscid parameters (which is accomplished 
through a call to algnshk.F). 


9. 1.3. 2. Guide to File data 

Typically, after LAURA is tailored to a given application, the path from initialization to 
convergence requires no additional compilations. Modifications to file data are the usei s pri- 
mary cont rol over LAURA runs. Some "rules of thumb" for these parameters are given below. 


nonl: 

For a cold-start initialization, the first-order accurate (nord = 1) scheme is more 
robust than the second-order finite-difference representation. However, after just a 
few hundred iterations, the switch to second order (non! = 2 ) should be made. 

NOTE: Although a first-order solution is an improvement over the cold- 
start initialization, it is computationally wasteful (and, in fact, counter- 
productive) to fully converge the first-order solution before switching to 
nord = 2 . 


i frozen : 

This toggle controls the chemical and thermal source terms for nonequilibrium flow. 
By default i frozen = 1 so that the source terms are turned on. With {frozen = 0. 
the chemically and thermally frozen flow is calculated. In such a case, there is no 
dissociation, but the fluid is not treated as a perfect gas (constant 7 ). 

ntrnsprt. and njcobian: 

As the solution is driven toward convergence, key flow field quantities vary less 
from iteration to iteration. Thus, a reduction in the frequency of updates to these 
variables can yield a savings in computational costs. For a cold-start, the Jacobian 
and transport properties are updated for each iteration ( njcobian - ntrnsprt = 1 ). 
As the residual drops, these numbers, which specify the number of iterat ions between 
updates, can be increased. 

tins, jvis , and kins: 

These are the toggles for the thin-laver viscous terms in the j-, and ^-directions, 
respectively. Each computational block has its own toggles. Setting tins = jvis = 
kvis = 1 for a given block DOES NOT yield the full Navier-Stokes equations 

(section 9.1.3). 
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attack, vinfb , cm/6. and tinf: 

1 l.o froo-st.roa.ni conditions can l.o altered at any time along the path to convergence. 
tnnpbc, twall. and apt: 

The wall temperature boundary condition can be altered at any time along the path 
to convergence, for a constant wall temperature, set. tcinpbc = () and define twall. For 
a specified wall temperature variation, set ttmpbr = 1 and supply t he file variabletw 
(section 9.1.0). for the radiative equilibrium wall temperature distribution (tnnpbc = 
2). the user must supply file TWALL. in (section 9.1.0). 

rjhif/th. zcg. xrg, rc /area, and rcflcn: 

1 he reference quantities for t he geometry can be altered at any time along the path 
to convergence. 

it (Tfj: 


I his parameter provides a maximum iteration limit for the current run. 

NOTE: The current job is terminated when either it erg iterations have 
been completed or the hr* time limit is reached, whichever comes first . 

movegrd , and maxmovey. 

for a given run, the flow field grid is realigned after every movegrd iteration (movegrd - 
0 yields no adjustments) up to maxrnovcs times. If maxmove * = 0, the grid will he 
adjusted every movegrd iteration for the duration of the run. 

iatm ig: 

This parameter controls the eigenvalue limiter scaling option. Although the default 
is labscig = 1 (scaled), a switch to iabseig = 0 (normal) can be required for some 

problems early in the relaxation process to survive difficult, transients as the solution 
evolves. 


cpsa: 


Dus parameter controls the fraction of the local maximum eigenvalue which is used 
as a lower limit for defining the upwind dissipation. For iabseig = 1, the fraction is 
further reduced in directions where ivis = 1, jvis = J, or kvis = 1 to substantially 
eliminate adverse effects on the computed heating and skin friction levels. 

cm/: 


If the self-starting feature of LAURA is employed, the initial grid contains only one- 
quarter of t he cells specified for the ^--direction. As the shock layer develops, and 
the residual drops, the number of cells in this direction is doubled twice. These 
enrichments are performed automatically when the residual drops below the value 
of cm/. In general, the timing of this doubling is not critical, so the default value is 
satisfactory. If the solution stagnates at a residual level above this value, however, 
the user can increase crnl to hasten the adjustment. 
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hr. s: 

This parameter provides the time limit for the current run. Its value should be 
matched to any time limit dictated by the machine or queue since it determines 
when the restart files are created. If the writing of these files is not completed when 
the limit is reached, the run will have to be repeated. 

NOTE: The current job is terminated when either iterg iterations have 
been completed or the hrs time limit is reached, whichever comes first. 

rfinv and rfvis: 

These factors multiply the inviscid matrix M/,,inv and the viscous matrix M/,.viSi 
which are the Jacobians ol the inviscid and viscous flux vectors, respectively. 

(Eq. (0.76) in appendix 0.) These factors have no influence on the converged so- 
lution (in the sense that they do not alter the expression for the residual vector), 
but they do affect the path to a converged solution. The change in the solution 
vector caused by changes in the inviscid contributions to the residual is inversely 
proportional to rfinv. In a similar manner, changes to the solution vector because 
of changes in the viscous contributions to the residual are inversely proportional to 
rfvis. Their lower bounds are rfinv = 1.5 and rfvis = 0.5. Although the defaults are 
rfinv = 2 and rfvis = 1, increasing these to rfinv = 3 and rfvis = 2 (or possibly more) 
can be required early in the relaxation process for some problems to survive difficult 
transients as the solution evolves. The relaxation factors can also be incieased in 
cases in which the convergence stalls because of a limit cycle induced by the use of the 
minmod function in the TVD scheme. Values significantly higher than these should 
not be required. As a general guide, low values tend to accelerate convergence after 
very large initial transients have passed. Larger values are appropriate if large initial 
transients are destabilizing or if the convergence has stalled because of limit cycles 
(probably in the vicinity of a captured shock) which are induced by the minmod 
function. 

9.1.4. File transition 

For turbulent flows ( nturb = 1,2), the location of the onset of transition (sir) is specified 
through the ASCII file transition. 

NOTE: This location (surface distance from the nose of the geometry) should be 
defined as str = 0 for the calculation of fully turbulent flows. 

NOTE: The present coding assumes that the i- and j -coordinates are measured in 
the streamwise and circumferential directions, respectively, along the body. Further, 
it assumes that 

• the nose point (,s = 0) lies in Block A 

• Block A is active 

A sample file is shown below for transition at str — 1.0 grid unit: 


l.o 
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9.1.5. File TWALL . in 


lor t( tnpbc = 0 (constant wall temperature), t ho wall temperature value is provided through 
file data (section 9.1.3). For tnnpbc = 1 (specified wall temperature variation), the wall temper- 
ature distribution is defined through file variabletw (section 9.1.6). l or tnnpbc = 2 (radiative 
equilibrium wall temperature), the wall temperature distribution is initialized through binary 
file TWALL. in. The size of this file is a function of the number of blocks (nblocks), the number 
of surfaces (nsrj), and the array dimensions. The read sequence for this unformatted file is: 


read (45) lsrf 

do 35 nn=l,lsrf 

read (45) imax , jmax 

read (45) (( twallv (i , j ,nn) , i=l,imax), j=l,jmax ) 
35 continue 


wliero lsrf is the number of surfaces and imax and jmax are the grid dimensions along a given 
surface. 1 his distribution is adjusted with each global iteration in LAURA. The adjustment is 
not a straight substitution, but rather il is a relaxation controlled by parameter (pi. which is 
read from file data. Willi the completion of a. LAURA run, TWALL. in is overwritten to reflect 
the current distribution. 

NOTE: The file TWALL .in must exist when tnnpbc = 2. However, its overwrite 
only occurs if f pt / 0. 1 his allows the wall boundary condition to be frozen at 

any time during the solution procedure. This specification can also allow a flow field 
distribution with a fixed wall boundary condit ion to be used to initialize a tnnpbc = 2 
case. For example, suppose that a fixed wall distribution ( tnnpbc = 0, 1; ept = 0) is 
specified for the early stages of flow field development. In a later run. set cpt / 0 to 
create a TWALL . in file. In the subsequent run, set tnnpbc — 2 (since TWALL . in now 
exists), and the solution picks up where it left off, except that the wall temperature 
is iteratively determined as part of the solution. 

9.1.6. File variabletw 

When a specified wall temperature variation is desired (for comparison with experimen- 
tal data, for instance), the wall temperature distribution must be supplied in the ASCII file 
variabletw. The surface distance and t he temperature are specified at discrete locations down 
the body (which is assumed to be in the /-direction). A free format is used to read in this 
distribution (one ordered pair [,s, T] per line) from file variabletw. LAURA interpolates these 
values to provide the proper distribution for the grid specified in RESTART, in. 

NOTE: Currently, this option ( tnnpbc = 1) is not available for three-dimensional 
flows. 

NOTE: The present coding assumes the /-coordinate is measured in the stream wise 
direction along the body. 

A sample file is shown below for a streamwi.se temperature distribution that varies from T w = 
313.9 K to T w ~ 2SS.3 K as a function of the surface distance from = 0.0 to = 12.5 grid 
units (screen 36): 



0.0 

313.9 

0.5225 

310.0 

1 . 0475 

313.9 

1.5700 

329.4 

2.0950 

331.7 

2.6175 

316.1 

3.1425 

298.9 

3.5775 

290.6 

3.9775 

288.9 

4.9775 

287.8 

5.9750 

288.3 

6.9725 

287.8 

7.9700 

287.8 

9.4675 

287.2 

10.4650 

287.2 

11.4625 

288.3 

12.5 

288.3 


Screen 36. 

9.2. Control Via Compilation 

9.2.1. File HEADER, st rt 

During make, each file in the LAURA source code is preprocessed before it is passed to the 
FORTRAN compiler. This preprocessing eliminates those sections of code which will be inactive 
for this case (as determined by user inputs). File HEADER. strt consists of a. series of “♦define 
statements for variables that control the compile directives. The number of definitions and their 
values are controlled by the user through stArt. The options for these definitions are given 
below, along with the FORTRAN variable that gives the user control over them. 

During the INSTALL_LAURA .4.1 procedure, mAch+prOc identifies the machine architecture, 
and this is in turn reflected in the first definition in HEADER. strt, as follows: 


#def ine CRAY .ARCHITECTURE 
#def ine SUN -ARCHITECTURE 
#def ine SGI-ARCHITECTURE 
#def ine CONVEX-ARCHITECTURE 


0 

1 

2 

3 


The next definition is dependent on tidim: 


#def ine AXISYMMETRIC-FLOW 1 ( 1 
#def ine TWO-DIMENSIONAL-FLOW Wor ndim = 2 
#def ine THREE J)IMENSIONAL_FLOW J ( :l 


This definition reflects the value of ngas: 


♦define PERFECT_GAS 
♦define EQUILIBRIUM 
♦define NONEQUILIBRIUM 


for ngas = 


0 

1 

2 
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For equilibrium flow, the value of icrv provides a definition: 

#def ine VINOKUR 1 J 1 

#def ine TANNEHILL J for lcrv = | 2 

For nonequilibrium flow, itherm is reflected in a. definition: 


#def ine ONE.TEMPERATURE 
#def ine TW 0 -TEMPERATURE 


for itherm ~ 


1 

2 


The user also has an option for laminar or turbulent flow (through nturb): 


#def ine LAMINAR_FLOW ) ( () 

#def ine TURBULENT_FL OW J for nlurb = j L2 

If turbulent flow is chosen, there is presently a. choice of two models (also available through 
nturb): " 

#def ine CEBECI_SMITH 1 f 1 

#def ine BALDWIN_LOMAX ] for nlnrb = j 2 

If — 2 and ns — 1. then an additional definition is created: 


#def ine ONE.SPECIES 


I he last, definition is a function of ujovcrn and specifies the governing equations: 


#def ine INVISCID 
#def ine THIN_LAYER 
#def ine NAVIER_STOKES 


> for hjovt rn 


0 

< 1 
2 


NOTE: Although this file can be modified directly, the user is strongly urged to 
make all changes by rerunning PRELUDE and modifying the variable that controls these 
definitions. I his prevents misspellings, but more importantly, the definitions of cer- 
tain variables are interrelated. For example, if “EQUILIBRIUM” is defined, then either 
"VINOKUR or "TANNEHILL" must also be defined. Remember, if file HEADER. strt is 
modified, make must be run again to reflect, the new specifications. 


9.2.2. File algnshk_vars . strt 

The file algnshk_vars . strt contains a, number of parameters that control the implemen- 
tation of algnshk . F (section 11.1.1). The default algnshk_vars . strt file is shown below 
(screen 37): 
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parameter ( recell - 1 . ) 

! cell Re at wall 

parameter ( jumpflag = 1 ) 

! flag for jump property 

parameter ( fctrjmp * 1.5 ) 

! factor for jump property 

parameter ( fsh * .8 ) 

! fraction of grid within shock layer 

parameter ( fstr = .5 ) 

! fraction of cells in stretch region 

parameter ( betagrd =0. ) 

! stretching function control 

C NOTE: epO not used if betagrd < 1 

parameter ( epO = 0. ) 

! no shock clustering 

C parameter ( epO = 25. / 4. ) 

! recommended max. value 


Screen 37. 

These parameters should be changed by editing a LOCAL copy of algnshk.vars . strt and running 
make again. 

9.2.3. File gas_model_vars . strt 

The file gas _model_vars . strt contains a number of parameters that reflect LAI HA defaults. 
The default gas_model_vars . strt file for the sample case presented in appendix A is shown 
below (screen 38): 



parameter ( bgas = .4 ) 

! gamma - 1 (used for PG , EQ) 


parameter ( wgas = 28.86 ) 

! air mol weight (used for PG , EQ) 

C: : 

PERFECT GAS VARIABLE: 



parameter ( prandtl = .71 ) 

! Prandtl Number 


Screen 38. 

For nonequilibrium flow's, the perfect gas Prandtl number assignment is replaced with the fol- 
lowing flags in gas _model_vars . strt (screen .19): 
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C : : NONEQUILIBRIUM FLAGS : 


parameter ( kmodel - 3 ) ! kinetic model option (1-5) 
parameter ( jtype = 0 ) ! ! wall catalysis option (0-6) 


parameter ( nsz = 11 ) 
parameter ( nsp = 16 ) 
parameter ( nrz = 27 ) 


• number of species defined in air.f 
! number of collision partners (kinetic) 
! number of allowed reactions (kinetic) 


Screen 39. 

I lie value of jtypr is defined by the user in stArt. This value ran be modified by rerun- 
ning PRELUDE or bv editing a LOCAL copy of gas_model_vars . strt. The oi lier parameters 
should be changed by editing a LOCAL copy of gas_model_vars . strt. Remember, if file 
gas_model_vars . strt is modified, make must be run again to reflect the new specifications. 


9.2.4. File i ssd_assn . strt 

I lie file issd.assn . strt contains the flag that toggles the solid-state device (SSD) on (’RAY 
architectures. The default issd_assn. strt file is shown below: 


parameter ( issd = 0 ) ! 0=off/l=on for SSD 


The value of issd should be changed by editing a LOCAL copy of issd_assn . strt and running 
make again. 

9.2.5. File iupwmd_assn . strt 

The file iupwind_assn . strt contains the flag that controls which TVD limiter is used. The 
default iupwind_assn . strt file is shown below: 


parameter ( iupwind = 0 ) ! option (0,1,2) for TVD limiter 


I he value of ivpwind should be changed by editing a LOCAL copy of iupwind_assn . strt and 
running make again. 

9.2.6. File mtaska_assn . strt 

1 he file mtaska_assn. strt contains the flag that toggles the adaptive partitioning of tasks. 
The default mtaska_assn . strt file is shown below: 

parameter ( mtaska = 0 ) ! adaptive partitioning of tasks 
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The value of mtaska should be changed by editing a LOCAL copy of mtaska_assn. strt and 
running make again. 


9.2.7. File nordbc_assn. strt 

The file nordbc_assn . strt contains the flag that controls the spatial accuracy of surface 
and outflow boundary conditions. The default nordbc_assn. strt file is shown below: 


parameter ( nordbc 35 1 ) ■ 1st or 2nd order BC 


The value of nordbc should be changed by editing a LOCAL copy of nordbc_assn . strt and 
running make again. 


9.2.8. File parameter . strt 

This file parameter. strt contains a number of parameters that reflect user inputs during 
the compilation of laura. The structure of parameter . strt is shown below (screen 40). 


parameter ( ns = 1 ) ! air is treated as 1 species for PG. EQ 

parameter ( neq — 5 ) ! . . .thus, there are 5 governing eqns 

parameter ( nblocks « 1 ) ! number of computational blocks 

parameter ( iaq = 30, ias = iaq + 1 ) \ block 1: M i"-cells 

parameter ( jaq = 1, jas = jaq + 1 ) ! 1: "j"-cells 

parameter ( kaq = 64, kas = kaq + 1 ) ! 1: "k'’-cells 

parameter ( isjs = iaq * jas ) ! max dimension of sweep plane 

parameter ( nsrf = 1 ) ! number of surfaces 

parameter ( isrf = 30, jsrf = 1 ) ! max surface dimensions 


Screen 40. 

The contents and length of (number of entries in) parameter . strt is application-specific 
and thus will differ from case to case. In addition to the above entries, the dimensions iaq/ and 
jaqf are included for full Navier-Stokes calculations. Also, the dimensions maxi, maxj , and maxk 
are defined for turbulent flow. 

NOTE: The dimensions of each computational block must be specified (e.g., iaq , 
jaq , and kaq for Block A and ibq , jbq< and kbq for Block B). 

The parameter nsrf defines the total number of solid surfaces in all computational blocks. The 
parameters isrf and jsrf give the maximum values for the first and second indices, respectively, 
of any active wall boundary. These parameters, along with iaqf, jaqf. neq, and m, are defined 
by stArt based on user inputs. Direct modification by the user via editing a LOCAL version 
of parameter. strt is unnecessary and discouraged. Changes to these parameters are best 
accomplished through running PRELUDE. 
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The parameter isjs is also defined by stArt, based on user inputs. A ^-directional sweep is 
assumed. If an /- or /-directional sweep will be employed, the value of isjs can be changed by 
editing a LOCAL copy of parameter . strt (section 11.3). 

PRELUDE should be rerun when the number of computational blocks ( n, blocks) is to be changed. 
This allows stArt to create the appropriate parameters for the block dimensions. The block 
dimensions themselves (such as iaq and jaq) also can be changed by editing a LOCAL copy of 
parameter . strt. 

Remember, if file parameter . strt is modified, make must be run again to reflect the new 
specifications. 

9.2.9. File sourcejvars . strt 

The file source_vars . strt contains flags used in file source. F ( nonequilibrium flows only). 
The default source_vars . strt file is shown below: 


parameter ( imptemp = 1 ) ! 0=ex/l=implicit T dependence 

parameter ( icharge = 1 ) ! toggle for el continuity eqn 


These parameters should be changed by editing a LOCAL copy of source.vars . strt and running 
make again. 

9.2.10. File sthrlnd_vars . strt 

The file sthrlncLvars . strt contains the coefficients for sthrlnd.F, which is Sutherland's 
law (used for perfect gas flows only). The default sthrlnd.vars . strt file is shown below: 


parameter ( vlgas = 1.4643e-6, v2gas = 112.222 ) 


These parameters should be changed by editing a LOCAL copy of sthrlnd.vars .strt and running 
make again. 


NOTE: Remember to use constants that are appropriate for temperature in I\. 







Chapter 10 

Output From LAURA 


In addition to t he standard (screen ) out put , a. number of files are generated during and at the 
do, a successful laura run. Information is written to the files algnshk.out and conv.out 

updated' “wxM I "fil' H ' ^ r ? ,,rl,lS,0,, I ° f ^ rU "’ the fil ° S RESTART ^ and TWALL.in are 

P lated. Next, the hie grid. out ,s created. The information contained in these files is discussed 

n this chaptei. Output from the sample case (appendix A) is shown. 


10.1. Screen Output 

1 he LAURA algorithm is executed interactively with the command 

(laura < data^ 

The progress of an interactive job can be monitored through the output that is written to the 
screen (standard output). This output can be redirected to file lfn with the command: 

(laura < data > lfiT) 

Tl„. standard output for tin- initial run of the sample case is displaced an, I discussed in the 
pages that follow. 


NOTE: In actuality, the contents of a number of files are echoed to the screen a 
the start of a run. The following information is contained in this preamble: 

• The contents of file data 

• The contents of file variabletw ( tempbr = 1 only) 

• The contents of file transition ( nturb > 0 only) 

• The contents of file ECHOSTRT (section 9) 

• A list of any LOCAL or CUSTOM files used in the compilation 

In the interest of brevity, this preamble is not shown here. 


The free-stream pressure and similarity parameters (which are calculated 
and the value of the Courant number for this run are output (screen 1 1 ): 


based on user inputs) 
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pressure 

0 . 57618E+02 N/m‘2 

Mach number 

17.605 

Reynolds number 

0 . 37693E+06 

Knuds en number 

0 . 78917E-04 

Courant number 

0.1E+07 


Screen \ 1 . 


A header identifies elements of the main screen output as follows 


tsk 

task number 

blk 

block number for this task 

ms 

sweep direction ( tnbk) for this task 

iter 

iteration number 

L2 norm 

running total of LI norms for all tasks 

tsk norm 

L2 norm for this task 

inf norm 

maximum residual for this task 

i, j, k, m 

index of cell and equation number (m), 

where the maximum residual for this task occur 

time 

value from system timer 

strt 

Istrt for this task 

stop 

Istop for this task 


In addition, as each processor comes on line, the message “CPI-' number 
to the screen (screen 42): 


starting” is issued 
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tsk 

blk 

ms 

iter 

L2 norm 

tsk norm 

inf norm 

i 

j 

k 

m 

time i 

strt 

stp 






CPU number 01 start 

ing 
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Grid adjusted after 

■ iter = 

20 









Screen 42. 
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Screen 42. Concluded. 
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As shown, messages are also issued when algnshk.F is called. Here, shock adjustment has 
men ieq nested after each 20 iterations. The confirmation message is “...Grid adjusted after it 
— — v (screen 4:$). 
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. 598E- 
. 027E- 
. 678E- 
. 136E- 
816E- 
289E- 
976E- 
457E- 
137E- 
616E- 
283E- 
745E- 
400E 
831E 
477E- 1 


-01 8.506E 
-01 5.473E 
-01 6.346E 
-01 4.670E 
-01 6.021E 
-01 4.598E 
-01 6.027E 
-01 4.678E 
01 6.136E- 
-01 4.816E- 
01 6.289E- 
01 4 . 976E- 
01 6.457E- 
01 5. 137E- 
01 6.616E- 
01 5.283E- 
01 6.745E- 
01 5 . 400E-* 
01 6.831E- 
01 5 . 477E-! 


-01 2.808E 
-01 1.369E 
-01 1.604E 
-01 1.063E- 
-01 1.322E- 
-01 1.017E- 
-01 1. 198E- 
01 9 . 944E- 
01 1.114E- 
■01 9.485E- 
01 1.164E- 
01 9.597E- 
01 1.228E- 
01 1.032E- 
01 1.228E- 
01 1.052E- 
01 1.180E- 
01 1.032E- 
01 1.098E- 
01 9.786E- 


-01 

-01 

-01 


01 


.Grid adjusted after iter 


80 


3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 


81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 


9.475E 
6.263E 
7.138E 
5.545E 
6.716E 
5.327E 
6.443E 
5.147E 
6.182E- 
4.956E- 
5.917E- 
4.751E- 
5.648E- 
4.536E- 
5 . 375E- 
4.313E- 
5. 100E- 
4.083E- 
4.823E- 
3.849E 


-01 9 . 475E-01 2 
01 6 . 263E-01 1 
-01 7.138E-01 1 
-01 5 . 545E-01 1 
-01 6.716E-01 1 
-01 5 . 327E-01 1 
-01 6 . 443E-01 1 
-01 5.147E-01 9 
-01 6 . 182E-01 1. 
01 4. 956E-01 9. 
-01 5 . 917E-01 1. 
01 4 . 751E-01 8. 
01 5 . 648E-01 9. 
01 4 . 536E-01 8. 
01 5.375E-01 9. 
01 4. 313E-01 8. 
01 5 . 100E-01 8. 
01 4 . 083E-01 7. 
01 4.823E-01 8. 
01 3 . 849E-01 7. 


. 255E- 
. 435E- 
. 328E- 
. 133E- 
. 173E- 
. 024E- 
, 108E- 
525E- 
058E- 
285E- 
012E- 
863E-' 
614E-I 
516E-I 
005E-I 
051EH 
575EH 
585E-( 
431E-( 
109E-( 


. . .Grid adjusted after iter = 100 


Screen 44. 
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The self-starting feature of LAURA is employed for this sample case. As mentioned in 
section 9.1.3, the initial grid contains only one-quarter of the cells specified for the ^-direction. 
As the shock layer develops, and the residual drops, the number of cells in this direction is 
doubled twice. With each doubling, the message “...Grid doubled after iter = — is issued. 
After the specified A-direction is achieved, further calls to algnshk.F will be accompanied by a 
warning message if the criteria for the cell Reynolds number at the wall is not met. As stated in 
section 9. 1.3.2, the variable maxmoves controls the number of times algnshk.F is called. W hen 
this value is exceeded, no further calls to algnshk.F are made, and the message “...Turning off 
algnshk after ___ adjustments” is issued. Each of these messages can be viewed in context in 
appendix A. where this sample case is discussed further. 

As each task finishes, a confirmation message is issued: 


CPU 1 terminated at 48.64 seconds (after 100 iterations). 


Routine taskit . F outputs t he integrated surface quantities (screen 44). 


Aerodynamic coefficients cx, cy , cz, gy and 
mass and energy flux through surfaces 
for each of 1 tasks are presented below 

No assumption of a half-body computation is 
is made here; consequently, cx, cz, and gy 
will need to be multiplied by 2 to obtain 
the correct aerodynamics when only half of 
the body is computed. 


integrated surface quantities: 

cx = 0 . 10319546E-01 

cy = 0 . OOOOOOOOE+OO 

cz = 0. 13448360E-01 

gy * -0 . 55733500E-02 
sumxndot * 0 . 32861283E-03 

sumheat = -0 . 10528496E-02 


Screen 44. 
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Routine wrapup. F outputs several reference quantities (xcg. 
in screen 45: 



zcy, refund . and ref Ini) a 

s shown 

x/rf lngth 

= O.OOOOOOOOE+OO 



z/rf lngth 

= O.OOOOOOOOE+OO 



area/ rf lngth"' 2 

= 0 . 3 1415901E+01 



length/rf lngth 

= 0 . 20000000E+01 



END ! END ! END ! END ! END ! 

END ! END ! END 

! END ! END 



Screen 45. 


NOTE: The call to routine output a. f is currently -commented out." If this ex- 
tended output is desired, simply reinstate this call in a. LOCAL version of wrapup. 

10.2. File algnshk . out 

I lie file algnshk. out contains information from each call to algnshk. F. This file is over- 
written with each laura run (provided algnshk. F is called). The output for the initial run of 
the sample case is displayed (screen 4(i) and discussed in the pages that follow. 
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. . .Grid adjusted after iter = 


i 

j 

hminl 

norm . 
dist . 

1 

1 

. 5489674E-05 

. 174746 

2 

1 

. 5470985E-05 

.174609 

3 

1 

. 5527656E-05 

. 175025 

4 

1 

. 5630268E-05 

.175771 

5 

1 

. 57801 12E-05 

.176844 

6 

1 

. 5982895E-05 

. 178264 

7 

1 

. 6246614E-05 

. 180060 

8 

1 

. 6577 184E-05 

.182235 

9 

1 

. 6984580E-05 

. 184810 

10 

1 

. 7481306E-05 

. 187808 

11 

1 

.8081044E-05 

. 191242 

12 

1 

. 8803757E-05 

.195146 

13 

1 

. 9672593E-05 

. 199547 

14 

1 

. 1071551E-04 

.204471 

15 

1 

. 1196553E-04 

.209941 

16 

1 

. 1346256E-04 

.215980 

17 

1 

. 1525572E-04 

.222617 

18 

1 

. 1740257E-04 

.229871 

19 

1 

. 1997267E-04 

.237766 

20 

1 

. 2304558E-04 

.246317 

21 

1 

.2671226E-04 

.255529 

22 

1 

. 3106547E-04 

.265379 

23 

1 

. 3620289E-04 

.275833 

24 

1 

. 4221089E-04 

.286822 

25 

1 

.491565SE-04 

.298248 

26 

1 

. 5708405E-04 

.309998 

27 

1 

. 6600447E-04 

.321944 

28 

1 

.7591113E-04 

.333975 

29 

1 

. 8692797E-04 

.346152 

30 

1 

. 9837 127E-04 

.357733 


20 


wall 

max. 

location of 

stretch 

stretch 

maximum 

2.212342 

4.168002 

.004896 

( 

5) 

2.213022 

4.169779 

.004890 

( 

5) 

2.210968 

4.164412 

.004908 

( 

5) 

2.207308 

4.154848 

.004941 

( 

5) 

2.202096 

4.141229 

.004988 

( 

5) 

2.195280 

4.123418 

.005050 

( 

5) 

2.186795 

4.101244 

.005129 

( 

5) 

2.176711 

4.074893 

.005225 

( 

5) 

2.165040 

4.044396 

.005339 

( 

5) 

2.151805 

4.009813 

.005473 

( 

5) 

2.137085 

3.971347 

.005626 

( 

5) 

2.120900 

3.929052 

.005803 

( 

5) 

2.103314 

3.883098 

.006003 

( 

5) 

2.084415 

3.833714 

.006228 

( 

5) 

2.064320 

3.781201 

.006481 

< 

5) 

2.043154 

3.725892 

.006762 

( 

5) 

2.021041 

3.668108 

.007074 

( 

5) 

1.998128 

3.608233 

.007418 

( 

5) 

1.974556 

3.546637 

.007796 

( 

5) 

1.950493 

3.483757 

.008210 

( 

5) 

1.926113 

3.420050 

.008660 

( 

5) 

1.901645 

3.356112 

.009146 

( 

5) 

1.877309 

3.292519 

.009667 

( 

5) 

1.853358 

3.229931 

.010220 

( 

5) 

1.830044 

3.169010 

.010801 

( 

5) 

1.807590 

3.110333 

.011404 

( 

5) 

1.786181 

3.054391 

.012023 

( 

5) 

1.765927 

3.001463 

.012650 

( 

5) 

1.746634 

2.951048 

.013291 

( 

5) 

1 .729310 

2.905780 

.013904 

( 

5) 


Screen 46. 


Each call to algnshk.F is annotated with the iteration count at the time of the call through 

the message "...Grid adjusted after iter = " A header identifies the quantities contained in 

this output (screen 46): 


j 

hminl 

norm. dist. 
wall stretch 
max stretch 

location 


station index 

height (dimension in A-direction) of cell adjacent to wall 
normalized distance from surface to outer grid boundary 
grid stretching factor at the wall 
maximum value of grid stretching factor used in the 
stretching region 

normal distance from body to point of maximum grid 
stretching (A*-index in parentheses) 




NOTE: The target value for normalized distance is ssl = j. A value of less 

t han unity indicated that the criterion for ncdl could not be met In such cases 
algnshk . F stretches the grid by a factor of l/,s, to encompass the bow "hlh t 

a resu t, he actual value of ncdl is greater than unity. If rccdl is of order 10 or 
greater, then heating results may be suspect. 


•Grid adjusted after iter 


.3131 174E-05 
. 3073462E-05 
. 3053028E-05 
. 3046536E-05 
. 3000777E-05 
. 2988069E-05 
. 3026658E-05 
. 3095165E-05 
. 3187 141E-05 
. 3320904E-05 
. 3528920E-05 
. 3828609E-05 
. 4074159E-05 
. 4354005E-05 
•4711490E-05 
. 5175733E-05 
. 578657 IE-05 
. 6567679E-05 
. 7450395E-05 
. 8442363E-05 
. 964961 IE-05 
. 1117308E-04 
. 1305955E-04 
. 1532536E-04 
. 1806137E-04 
. 2145 109E-04 
. 2605639E-04 
. 3138540E-04 
. 3727448E-04 
•4341805E-04 


r iter = 

40 


norm . 

wall 

max . 

dist . 

stretch 

stretch 

. 153732 

2.328307 

4.471033 

. 153089 

2.332290 

4.481442 

. 152860 

2.333721 

4.485180 

152787 

2.334177 

4.486374 

152267 

2.337429 

4.494869 

152122 

2.338341 

4.497254 


.152562 
. 153332 
. 154347 
. 155786 
. 157941 
. 160890 
. 163183 
. 165677 
. 168700 
.172387 
. 176890 
. 182173 
. 187625 
. 193224 
. 199434 
.206523 
.214403 
.222863 
.231969 
.241988 
.253949 
266064 
277881 
288897 


2.335583 

2.330782 

2.324522 

2.315771 

2.302921 

2.285834 

2.272920 

2.259228 

2.243113 

2.224126 

2.201875 

2.176993 

2.152600 

2.128798 

2.103756 

2.076767 

2.048581 

2.020242 

1.991729 

1.962495 

1.930186 

1.900001 

1.872723 

1.849009 


4.490047 

4.477502 

4.461143 

4.438275 

4.404697 

4.360046 

4.326299 

4.290522 

4.248410 

4.198796 

4. 140651 

4.075630 

4.011889 

3.949692 

3.884253 

3.813727 

3.740074 

3.666021 

3.591513 

3.515120 

3.430694 

3.351817 

3.280536 

3.218566 


location of 
maximum 

.004002 ( 5) 
.003975 ( 5) 
.003966 ( 5) 
.003963 ( 5) 
.003941 ( 5) 
.003935 ( 5) 
.003953 ( 5) 
.003985 ( 5) 
.004027 ( 5) 
.004087 ( 5) 
.004177 ( 5) 
.004302 ( 5) 
.004399 ( 5) 
.004505 ( 5) 
.004634 ( 5) 
.004794 ( 5) 
.004990 ( 5) 
.005222 ( 5) 
.005464 ( 5) 
.005716 ( 5) 
.005997 ( 5) 
.006323 ( 5) 
.006688 ( 5) 
.007085 ( 5) 
.007518 ( 5) 
.008000 ( 5) 
.008582 ( 5) 
.009180 ( 5) 
.009770 ( 5) 
.010326 ( 5) 


Screen 46. Continued. 
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Grid adjusted after iter * 


60 


norm. wall max. location of 

j hminl dist. stretch stretch maximum 

1 .3508999E-05 .157739 2.304114 4.407815 .004169 ( 5) 

1 . 3354738E-05 .156143 2.313620 4.432655 .004102 ( 5) 

1 . 3344006E-05 .156030 2.314300 4.434431 .004098 ( 5) 

1 . 3339437E-05 .155982 2.314590 4.435188 .004096 ( 5) 

1 . 3350345E-05 .156097 2.313898 4.433381 .004100 ( 5) 

1 . 3404264E-05 .156661 2.310516 4.424542 .004124 ( 5) 

1 . 3503191E-05 .157680 2.304464 4.408728 .004167 ( 5) 

1 36403 14E-05 .159058 2.296386 4.387619 .004224 ( 5) 

1 3796423E-05 .160581 2.287596 4.364650 .004289 ( 5) 

1 . 3991909E-05 .162426 2.277146 4.337342 .004367 ( 5) 

1 . 4272193E-05 .164960 2.263126 4.300707 .004474 ( 5) 

1 . 468500 IE-05 .168482 2.244259 4.251406 .004625 ( 5) 

1 . 50976 16E-05 .171784 2.227184 4.206786 .004767 ( 5) 

1 . 5487607E-05 .174731 2.212417 4.168198 .004895 ( 5) 

1 . 5779021E-05 .176836 2.202134 4.141326 .004987 ( 5) 

1 6047434E-05 .178709 2.193165 4.117891 .005069 ( 5) 

1 . 6394840E-05 .181045 2.182201 4.089240 .005172 ( 5) 

1 . 6905384E-05 .184318 2.167248 4.050166 .005317 ( 5) 

1 .7591859E-05 .188455 2.148994 4.002467 .005501 ( 5) 

1 8422231E-05 .193115 2.129250 3.950871 .005711 ( 5) 

1 . 9356654E-05 .197980 2.109495 3.899251 .005931 ( 5) 

1 . 1032634E-04 .202675 2.091215 3.851483 .006146 ( 5) 

1 . 1139707E-04 .207506 2.073150 3.804276 .006368 ( 5) 

1 '. 1272952E-04 .213086 2.053168 3.752060 .006627 ( 5) 

1 . 1439538E-04 .219506 2.031263 3.694821 .006927 ( 5) 

1 1631982E-04 .226297 2.009260 3.637323 .007248 ( 5) 

1 . 1871878E-04 .234010 1.985600 3.575498 .007616 ( 5) 

1 2174829E-04 .242811 1.960183 3.509079 .008039 ( 5) 

1 .2533116E-04 .252170 1.934827 3.442820 .008495 ( 5) 

1 . 2964231E-04 .262271 1.909196 3.375843 .008992 ( 5) 


Screen 46. Continued. 



•Grid adjusted after iter = 


. 3443899E-05 
. 3344942E-0S 
•3335160E-05 
. 3350440E-05 
. 3385750E-05 
. 3459766E-05 
. 3586949E-05 
. 3762755E-05 
. 3981 143E-05 
. 4236447E-05 
.45447 17E-05 
•4961024E-05 
. 5386835E-05 
. 5902483E-05 
. 6528443E-05 
. 7 167620E-05 
. 7747829E-05 
. 8422861E-05 
. 9293064E-05 
. 1031082E-04 
. 1144234E-04 
. 1268032E-04 
. 1402284E-04 
. 1551981E-04 
. 1731760E-04 
. 1948574E-04 
. 207 1425E-04 
. 23733 17E-04 
. 2726277E-04 
. 3143247E-04 


norm. 

wall 

max . 

dist . 

stretch 

stretch 

. 157072 

2.308067 

4.418145 

. 156040 

2.314240 

4.434276 

.155936 

2.314862 

4.435899 

. 156098 

2.313892 

4.433365 

156468 

2.311670 

4.427559 

157235 

2.307096 

4.415607 

158526 

2.299488 

4.395726 

160256 

2.289457 

4.369513 

162326 

2.277706 

4.338807 

164644 

2.264856 

4.305227 

167311 

2.250453 

4.267592 

170713 

2.232659 

4.221092 


. 173984 
. 177705 
. 181919 
. 185932 
.189357 
.193118 
.197661 
.202602 
.207703 
.212888 
.218118 
.223546 
.229596 
.236328 
.239910 
248119 
256834 
266164 


2.216117 

2.197951 

2.178161 

2.160043 

2. 145106 

2.129235 

2.110768 

2.091492 

2.072429 

2.053863 

2.035905 

2.018033 

1.998973 

1.978750 

1.968385 

1.945602 

1.922780 

1.899761 


4.177866 

4.130398 

4.078684 

4.031340 

3.992305 

3.950834 

3.902576 

3.852207 

3.802392 

3.753877 

3.706950 

3.660248 

3.610441 

3.557596 

3.530511 

3.470978 

3.411340 

3.351189 


location of 
maximum 

.004141 ( 5) 
.004098 ( 5) 
.004094 ( 5) 
.004100 ( 5) 
.004116 ( 5) 
.004148 ( 5) 
.004202 ( 5) 
.004275 ( 5) 
.004362 ( 5) 
.004461 ( 5) 
.004575 ( 5) 
.004721 ( 5) 
.004863 ( 5) 
.005025 ( 5) 
.005211 ( 5) 
.005389 ( 5) 
.005542 ( 5) 
.005711 ( 5) 
.005917 ( 5) 
.006142 ( 5) 
.006377 ( 5) 
.006617 ( 5) 
.006862 ( 5) 
.007118 ( 5) 
.007405 ( 5) 
.007727 ( 5) 
.007899 ( 5) 
.008297 ( 5) 
.008724 ( 5) 
.009185 ( 5) 




. .Grid adjusted after iter - 100 


i 

j 

hminl 

norm, 
dist . 

1 

1 

. 3029219E-05 

.152591 

2 

1 

. 2933087E-05 

.151489 

3 

1 

. 2936879E-05 

. 151533 

4 

1 

. 2960495E-05 

. 151806 

5 

1 

. 3003706E-05 

. 152301 

6 

1 

. 3081789E-05 

.153183 

7 

1 

. 3205760E-05 

. 154550 

8 

1 

. 3374143E-05 

. 156346 

9 

1 

. 3584373E-05 

. 158500 

10 

1 

. 3842867E-05 

. 161026 

11 

1 

.4162814E-05 

.163986 

12 

1 

.4581392E-05 

. 167620 

13 

1 

. 5011667E-05 

. 171112 

14 

1 

. 5448393E-05 

. 174442 

15 

1 

. 5972503E-05 

.178192 

16 

1 

. 6650755E-05 

.182708 

17 

1 

.7315495E-05 

. 186823 

18 

1 

.7972187E-05 

.190633 

19 

1 

.8791758E-05 

. 195083 

20 

1 

.9810880E-05 

.200221 

21 

1 

. 1100337E-04 

.205769 

22 

1 

. 1234660E-04 

.211527 

23 

1 

. 1386875E-04 

.217536 

24 

1 

. 1561514E-04 

.223879 

25 

1 

. 1764181E-04 

.230639 

26 

1 

. 2002684E-04 

.237925 

27 

1 

. 2206557E-04 

.243682 

28 

1 

. 2543164E-04 

.252418 

29 

1 

.2930744E-04 

.261525 

30 

1 

.3366429E-04 

.270807 


wall max. location of 

stretch stretch maximum 

2.335401 4.489572 .003955 ( 5) 

2.342341 4.507707 .003909 ( 5) 

2.342063 4.506979 .003911 ( 5) 
2.340337 4.502469 .003922 ( 5) 

2.337219 4.494321 .003943 ( 5) 

2.331710 4.479927 .003979 ( 5) 
2.323279 4.457895 .004036 ( 5) 

2.312398 4.429461 .004111 ( 5) 

2.299639 4.396121 .004201 ( 5) 

2.285059 4.358021 .004307 ( 5) 

2.268471 4.314673 .004433 ( 5) 

2.248814 4.263307 .004588 ( 5) 

2.230609 4.215737 .004738 ( 5) 

2.213848 4.171937 .004883 ( 5) 

2.195623 4.124314 .005047 ( 5) 

2.174544 4.069232 .005246 ( 5) 

2.156110 4.021062 .005429 ( 5) 

2.139664 3.978085 .005599 ( 5) 

2.121156 3.929722 .005800 ( 5) 

2.100679 3.876214 .006033 ( 5) 

2.079562 3.821031 .006288 ( 5) 

2.058660 3.766412 .006554 ( 5) 

2.037866 3.712074 .006835 ( 5) 

2.016961 3.657447 .007133 ( 5) 

1.995773 3.602080 .007454 ( 5) 

1.974096 3.545436 .007804 ( 5) 

1.957754 3.502732 .008082 ( 5) 

1.934175 3.441117 .008507 ( 5) 

1.911032 3.380641 .008955 ( 5) 

1.888812 3.322577 .009416 ( 5) 


Screen 46. Concluded. 
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10.3. File conv . out 


'*!. ° C ° nV ,;° U , t C ° ll,ains a ru,,ni,, R convergence history for the laura runs within the 
LOCAL directory. Wnti) each laura run, new information is appended to this file. The output for 
ie initial run of the sample case is displayed and discussed in the pages that follow. 

A header identifies the quantities contained in this output: 


tsk task number 

it er iteration number 

L2 norm running total of 1/2 norms for all tasks 
time CPI' time, s 


In addition, surface pressure values at 
NOTE: For viscous calculation 


two stations are output for each iteration (screen 17). 
s, surface heating is output at these same stations. 




body pressure 

body heating 

tsk 

iter residual 

time (sec) (stag) 

(end) 

(stag) (end) 

1 

1 . 11125 1E+02 

0.490 . 576182E-02 

. 576182E-02 

0. 0. 

1 

2 . 380023E+02 

0.960 . 731007E-02 

. 577053E-02 - 

. 123807E-05 -.382043E-07 

1 

3 . 11997 1E+02 

1.440 . 182999E-01 

. 580280E-02 - 

. 177536E-04 -. 107455E-06 

1 

4 , 21067 1E+02 

1.910 . 310216E-01 

. 584124E-02 - 

. 248138E-04 -.175231E-06 

1 

5 . 946205E+0 1 

2.400 . 522144E-01 

. 593069E-02 - 

. 358498E-04 -.298696E-06 

1 

6 . 145876E+02 

2.880 . 744622E-01 

. 602070E-02 - 

. 357327E-04 -.413637E-06 

1 

7 . 756324E+01 

3.350 .106214 

-617230E-02 - 

. 486654E-04 -.597005E-06 

1 

8 . 109528E+02 

3.830 .137500 

. 63 1392E-02 - 

■ 477209E-04 - .76002SE-06 

1 

9 . 620669E+01 

4.300 .180147 

. 652168E-02 - 

. 611696E-04 -. 99726 IE-06 

1 

10 . 855677E+01 

4.770 .219581 

. 670997E-02 - 

. 596799E-04 -.120258E-05 

1 

11 . 522298E+01 

5.250 .271032 

.696753E-02 - 

. 727976E-04 -.148395E-05 

1 

12 . 685348E+01 

5.720 .316603 

. 7 19903E-02 - 

. 706604E-04 -.172464E-05 

1 

13 . 448989E+01 

6.200 .374367 

. 750296E-02 - 

. 825884E-04 -.204073E-05 

1 

14 . 558383E+01 

6.670 .423743 

. 777719E-02 - 

. 797326E-04 -.231121E-05 

1 

15 . 392410E+01 

7.150 .485712 

. 812735E-02 - 

. 898725E-04 -.265473E-05 

1 

16 . 461184E+01 

7.620 .536903 

. 844679E-02 - 

. 865855E-04 - . 295223E-05 

1 

17 . 347849E+01 

8.100 .600625 

. 884606E-02 - 

. 946827E-04 331940E-05 

1 

18 . 385990E+01 

8.570 .651774 

.921598E-02 - 

. 914467E-04 -.364512E-05 

1 

19 . 312473E+01 

9.050 .713986 

. 966994E-02 - 

975128E-04 -.403683E-05 

1 

20 . 327746E+01 

9.520 .762802 

. 100980E-01 - 

947210E-04 -.439681E-05 

1 

21 . 387234E+01 

10.140 .819925 

106146E-0 1 - 

320804 - . 672383E-03 

1 

22 . 251388E+01 

10.620 .664872 

115725E-01 - 

145658 - . 908540E-03 

1 

23 . 18759 1E+01 

11.100 .625742 

111105E-01 - 

108364 - . 743926E-03 

1 

24 . 205793E+01 

11.580 .644236 

106750E-01 - 

931990E-01 - . 60229 IE-03 

1 

25 . 148929E+01 

12.060 .658604 

104534E-01 

798007E-01 - . 500528E-03 


Screen 47. 

NOTE: The pressure and heating output for this file is for Surface #1, assuming 
the following: 

• * = 1 for the stagnation line 




• i = iaq at the aft most point of the body 

• j - jaq is the leeside symmetry plane 

• k = 1 is the body surface 

If these assumptions are true, then the output contains leeside values at the stagna- 
tion and body-end locations. This output can be altered in a LOCAL version of file 
swptask.F (screen 4K). 


1 

26 . 187973E+01 

12.540 . 

685238 

1 

27 . 141504E+01 

13.020 .712985 

1 

28 . 182014E+01 

13.490 .741987 

1 

29 . 142090E+01 

13.970 .779123 

1 

30 . 168131E+01 

14.460 . 

.812621 

1 

31 . 135707E+01 

14.930 .855967 

1 

32 . 144442E+01 

15.410 

.892370 

1 

33 . 120762E+01 

15.890 

.936180 

1 

34 . 116881E+01 

16.360 

.971330 

1 

35 . 102043E+01 

16.840 1.00944 

1 

36 .912701E+00 

17.310 1.03906 

1 

37 . 845157E+00 

17.780 1.06690 

1 

38 . 707287E+00 

18.260 1.08814 

1 

39 .706961E+00 

18.730 1.10360 

1 

40 . 558819E+00 

19.210 1.11545 

1 

41 . 264632E+01 

19.840 1.11871 

1 

42 . 138680E+01 

20.310 

.990941 

1 

43 . 108160E+01 

20.790 

.975642 

1 

44 . 759772E+00 

21.260 

.995075 

1 

45 . 675046E+00 

21.730 1.01105 

1 

46 . 521515E+00 

22.200 1.02706 

1 

47 . 534753E+00 

22.680 1.03041 

1 

48 . 405861E+00 

23.150 1.03411 

1 

49 . 458732E+00 

23.620 1.02696 

1 

50 . 338284E+00 

24.100 1.02335 

1 

51 . 422194E+00 

24.570 1.01128 

1 

52 . 307 17 1E+00 

25.050 1.00451 

1 

53 . 414815E+00 

25.520 

.991727 

1 

54 . 301292E+00 

25.990 

.984499 

1 

55 . 424912E+00 

26.440 

.973628 

1 

56 . 310424E+00 

26.910 .967772 

1 

57 . 444238E+00 

27.380 .960182 

1 

58 . 328462E+00 

27.850 

.956560 

1 

59 .4687 10E+00 

28.310 

.952188 

1 

60 . 351790E+00 

28.780 

.950565 


. 104241E-01 -.742116E-01 -.448847E-03 
. 105541E-01 - . 691393E-01 -.411082E-03 
. 107443E-01 -.661469E-01 -.391369E-03 
. U1720E-01 -.646882E-01 -.390305E-03 
. 115689E-01 -.629977E-01 -.387193E-03 
. 122886E-01 -.630703E-01 -.411887E-03 
. 128973E-01 - .620696E-01 -.420021E-03 
. 138827E-01 62447 IE-01 -.463032E-03 

. 146829E-01 -.617338E-01 --479173E-03 
. 158844E-01 - . 617355E-01 -.534729E-03 
. 168356E-01 -.610563E-01 -.556667E-03 
. 181956E-01 -.603972E-01 -.620733E-03 
. 192521E-01 -.596093E-01 -.647104E-03 
. 207174E-01 -.582580E-01 -.717083E-03 
. 218388E-01 - . 572949E-01 -.747088E-03 
. 233640E-0 1 - . 149085 - . 180440E-02 

. 227 179E-01 - .877278E-01 -.121301E-02 
. 234899E-01 -.705461E-01 -.110537E-02 
. 244906E-01 -.628068E-01 -.105261E-02 
. 261073E-01 - . 582437E-01 -.113698E-02 
.273711E-01 - .557855E-01 -.116241E-02 
. 290843E-01 -.525408E-01 -.128204E-02 
. 303302E-01 -.507998E-01 -.132489E-02 
. 319379E-01 -.477138E-01 -.144554E-02 
. 330659E-01 -.461257E-01 -.149167E-02 
. 344691E-01 -.432762E-01 -.160161E-02 
. 354251E-01 -.418525E-01 -.164569E-02 
. 365875E-01 -.394433E-01 -.174167E-02 
. 373586E-01 -.382823E-01 -.178186E-02 
. 382930E-01 - .363805E-01 -.186485E-02 
. 388980E-01 -.3S4510E-01 -.190109E-02 
. 396481E-01 - . 340157E-01 -.197423E-02 
. 401247E-01 -.332922E-01 -.200740E-02 
. 407444E-01 -.322725E-01 -.207419E-02 
.411335E-01 -.31743 IE-01 -.210541E-02 


Screen 48. 


NOTE: The evaluation of surface-property convergence histories at key stations 

provides the user a measure of overall solution (pinlitv . 
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1 

61 

. 850596E+00 

29.410 

.948460 

1 

62 

. 547339E+00 

29.880 

.948563 

1 

63 

. 634605E+00 

30.360 

.948449 

1 

64 

. 467012E+00 

30.840 

.949105 

1 

65 

. 602136E+00 

31.300 

.948940 

1 

66 

. 459770E+00 

31.770 

.949398 

1 

67 

, 602692E+00 

32.250 

.948551 

1 

68 

. 467766E+00 

32.730 

.948434 

1 

69 

. 6 13552E+00 

33.200 

.946742 

1 

70 

. 481572E+00 

33.690 

.945992 

1 

71 

. 628930E+00 

34.160 

.943582 

1 

72 

. 497649E+00 

34.640 

.942315 

1 

73 

. 645697E+00 

35.110 

.939434 

1 

74 

. 513746E+00 

35.580 

.937832 

1 

75 

. 66 1562E+00 

36.050 

.934748 

1 

76 

. 528288E+00 

36.530 

.933003 

1 

77 

. 674542E+00 

37.000 

.929956 

1 

78 

. 539965E+00 

37.470 

.928232 

1 

79 

. 683 141E+00 

37.950 

.925408 

1 

80 

. 547736E+00 

38.420 

.923830 

1 

81 

. 94747 1E+00 

39.050 

.921340 

1 

82 

. 626324E+00 

39.520 

.920000 

1 

83 

. 7 13803E+00 

39.990 

.918149 

1 

84 

. 554506E+00 

40.470 

.917174 

1 

85 

. 67 1584E+00 

40.940 

.915432 

1 

86 

. 532733E+00 

41.420 

.914459 

1 

87 

. 644253E+00 

41.890 

.912434 

1 

88 

. 5147 15E+00 

42.370 

.911200 

1 

89 

. 6 18159E+00 

42.840 

.909047 

1 

90 

. 49559 1E+00 

43.320 

.907726 

1 

91 

. 59165 1E+00 

43.800 

.906105 

1 

92 

. 475097E+00 

44.270 

.905235 

1 

93 

. 564757E+00 

44.750 

.904807 

1 

94 

. 453562E+00 

45.240 

.904838 

1 

95 

. 537530E+00 

45.720 

.905790 

1 

96 

. 43 1251E+00 

46.190 

.906793 

1 

97 

. 5 10013E+00 

46.660 

.908774 

1 

98 

. 408316E+00 

47.170 

.910439 

1 

99 

. 482306E+00 

47.640 

.912810 

1 

100 

. 384926E+00 

48.120 

.914660 


.416678E-01 - . 286832E-01 -.344605E-02 
. 417388E-01 -.284228E-01 -.339051E-02 
. 410546E-01 - . 280350E-01 -.303522E-02 
■409112E-01 -.278070E-01 -.287296E-02 
•413617E-01 -.274168E-01 -.281162E-02 
.418904E-01 -.271860E-01 -.277444E-02 
. 425978E-01 -.267535E-01 -.280622E-02 
. 431 159E-01 -.265035E-01 -.281138E-02 
. 436512E-01 -.260277E-01 -.285886E-02 
. 439743E-01 -.257603E-01 -.287497E-02 
. 442799E-01 -.252590E-01 -.291761E-02 
. 444268E-01 -.249838E-01 -.293502E-02 
. 44551 IE-01 - . 244791E-01 -.296840E-02 
. 445759E-01 -.242066E-01 -.298386E-02 
. 445759E-01 -.237177E-01 -.300797E-02 
. 445233E-01 -.234567E-01 -.302049E-02 
. 444426E-01 -.229982E-01 -.303656E-02 
. 443426E-01 -.227547E-01 -.304610E-02 
.442109E-01 -.223357E-01 -.305567E-02 
. 440827E-01 -.221133E-01 -.306261E-02 
.439193E-01 - . 196904E-01 -.288311E-02 
.438014E-01 195132E-01 -.289676E-02 
. 436628E-01 -.192458E-01 -.290991E-02 
. 435304E-01 -.190964E-01 -.291886E-02 
. 433683E-01 -.188434E-01 -.292608E-02 
. 432243E-01 -.187013E-01 -.293225E-02 
. 430440E-01 184372E-01 -.293489E-02 
. 428909E-01 -.182908E-01 -.293897E-02 
. 426969E-01 -.180330E-01 -.293804E-02 
.425373E-01 -.178930E-01 -.294051E-02 
. 423334E-01 -.176850E-01 -.293673E-02 
•421696E-01 - . 175700E-01 -.293793E-02 
. 419585E-01 - . 174521E-01 -.293179E-02 
.417919E-01 - . 173834E-01 -.293193E-02 
. 415754E-01 - . 173611E-01 -.292377E-02 
. 414069E-01 173407E-01 -.292300E-02 
•411863E-01 173840E-01 -.291307E-02 
. 410167E-01 173953E-01 -.291151E-02 
•407933E-01 -.174585E-01 -.290007E-02 
. 406232E-01 -.174777E-01 -.289783E-02 



Screen 48. Concluded. 
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10.4. File grid. out 

The file grid. out contains information about grid resolution at each surface defined by the 
user. This file is overwritten at the conclusion of each laura run. The output for the initial run 
of t he sample case is displayed and discussed here. 

Each surface of each computational block has its own section, which is annotated with the 
number of cells normal to the body through the message “Block Surface . (__ cells normal to 
body).” A header identifies the quantities contained in the following output (screen 19): 

i, j station index 

dh_w height (dimension in /.'-direction ) of cell adjacent 

to wall 

Recell_w value of cell Reynolds number (rccrtl) at the 
wall for this station 

max stretch maximum value of grid stretching factor used in 
the stretching region (fc-index of location in 
parentheses) 

y+_w value of normal coordinate parameter ( y + ) at 

the wall for this station (nturb / 0 only) 
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Block ] 

L, Surface 1 




(16 cells 

normal to body) 


i 

j 

dh_w 

Recell_w max 

. stretch 

1 

1 

. 321 195E-05 

6.958525 

4.49 ( 6) 

2 

1 

. 328374E-05 

7.247622 

4.50 ( 6) 

3 

1 

. 338243E-05 

7.303569 

4.51 ( 6) 

4 

1 

. 348394E-05 

7.302690 

4.50 ( 6) 

5 

1 

. 359983E-05 

7.295987 

4.49 ( 6) 

6 

1 

. 374088E-05 

7.284156 

4.48 ( 6) 

7 

1 

.389317E-05 

7.222345 

4.46 ( 6) 

8 

1 

.407609E-05 

7.150728 

4.43 ( 6) 

9 

1 

. 429236E-05 

7.064906 

4.39 ( 6) 

10 

1 

. 457386E-05 

6.984239 

4.36 ( 6) 

11 

1 

. 497868E-05 

6.957453 

4.31 ( 6) 

12 

1 

. 55 1343E-05 

6.928688 

4.26 ( 6) 

13 

1 

. 6 10366E-05 

6.945080 

4.21 ( 6) 

14 

1 

. 665580E-05 

6.854008 

4.17 ( 6) 

15 

1 

.73787 IE-05 

6.824148 

4.12 ( 6) 

16 

1 

. 8 18040E-05 

6.740974 

4.07 ( 6) 

17 

1 

. 903207E-05 

6.585194 

4.02 ( 6) 

18 

1 

. 987771E-05 

6.303515 

3.97 ( 6) 

19 

1 

. 111265E-04 

6.146283 

3.93 ( 6) 

20 

1 

. 125892E-04 

5.961880 

3.87 ( 6) 

21 

1 

. 144564E-04 

5.827547 

3.82 ( 6) 

22 

1 

. 166364E-04 

5.676118 

3.76 ( 6) 

23 

1 

. 191056E-04 

5.484815 

3.71 ( 6) 

24 

1 

. 221322E-04 

5.323339 

3.65 ( 6) 

25 

1 

. 258567E-04 

5.191367 

3.60 ( 6) 

26 

1 

. 302 151E-04 

5.039758 

3.55 ( 6) 

27 

1 

. 3527 13E-04 

5.029430 

3.49 ( 6) 

28 

1 

. 418457E-04 

4.834682 

3.44 ( 6) 

29 

1 

. 498752E-04 

4.627432 

3.38 ( 6) 

30 

1 

. 587542E-04 

4.395599 

3.33 ( 6) 


Screen 49. 
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10.5. Post-Processing Files 

Six files that allow graphical presentation of results are created at the conclusion of every 
LAURA run. These files are in PL0T3D format, but they can he easily converted to Tec plot™ 
format (ref. 27). The files flowl.g and surfl.g contain the volume grid and surface grid, 
respectively, written in a multi block format (even when only one block is present). 

The file flowl.q contains the nondimensional values of density, //-, c-, and ir-components of 
velocities (in the .r-, y -, and ^ directions, respectively), and pressure. 

NOTE: Although computations are performed at cell centers by laura, the values 
in the file flowl .q have been interpolated/extrapolated to cell corners for the entire 
volume grid. 


NOTE: If the file RESTART, in is produced by PRELUDE, the initial values of these 
flow field variables are written to files flowO.g and flowO.q. This is also the case if 
INITIALIZE is used to initialize an externally generated grid. 


The file f low2 . q contains the translational and vibrational temperatures [K], the nondimensional 
total enthalpy, the Mach number, and the ratio of frozen specific heats interpolated /extrapolated 
to cell corners for the entire volume grid. Any other computed quantity can be substituted in 
routine plotprep.F. 

The first, two entries of file surf l.q are p and q , the surface pressure [lbf/ft 2 ] and heating 
rate [Btu/ft 2 -s], respectively. For viscous ( igovtrn ^ 0), radiative equilibrium w r all temperature 
( temp be — 2) flows, the last three entries are the: 

• surface temperature, K 

• radiative equilibrium wall temperature, based on the local heating rate and an assumed 
emissivity of 0.9 


• relative difference between the actual wall temperature and the radiative equilibrium wall 
temperature 

Otherwise (for inviscid and/or fixed wall temperature flows), the last three entries are p//> max , 
(/A/max* and p/po o- The first three entries of file surf 2. q are the ;t-, y and --components of 
the shear stress on the body surface. The fourth entry is the total shear stress, and the fifth is 
the coefficient of skin friction. 

To convert these files to Tecplot ™ format, use the command 

f preplot in file -plot3d -f -m -3dwl 


along with the desired -ip, -jp, or -kp instructions (ref. 27), where 


infile — 


flowl 
f low2 
surf 1 
surf 2 


NOTE: The command preplot is a preprocessor that is part of the Tecplot.™ 

package. 
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Chapter 11 


Advanced Applications 


11.1. Grid Orientation 

Although not. a requirement, in hypersonic blunt-hody applications, the origin of the coordi- 
nate system generally sits at or near the stagnation point on the body, with the c-axis pointing 
out from the body toward the oncoming flow, as shown in figure 2.1. The y = 0 plane defines 
the symmetry plane. Lifting-body applications retain this orientation, with the origin of the 
coordinate system at or near the vehicle stagnation point, the --axis pointing out from the nose, 
against the flow, and the negative ~-axis typically running through the interior of the vehicle. 

Computational coordinates (£. ?/, £) run in the direction of increasing j-. and A indices, 
respectively, as shown in figure 2.2. The vehicle surface grid is usually defined by the k = 1 plane 
because the shock alignment and cell-doubling features of LAURA require that the ^.-coordinate 
be in the body-normal direction. 

Axisym metric and two-dimensional flows are computed with three-dimensional grids, which 
contain a single j-plane of cell centers and two j-planes of cell walls. A representative axisym- 
metric surface grid (k — 1) is presented in figure 11.1. The pie-shaped cut is hounded by the 
j = 1 plane (negative ^-coordinate) and the j = 2 plane (positive //-coordinate). The i index 
equals 1 at the axis ([.r.*/] = [0.0]) and increases from there toward the end of the body. The 
/-planes are rotated ±2.5 deg around the --axis relative to the y = 0 plane for a total included 
angle of 5 deg. In the case of a two-dimensional configuration, the j-planes are offset from the 
y — 0 plane by ±1 unit. The volume grid is constructed by defining rays normal to the body 
in the y = 0 plane and rotating ±2.5 deg for axisymmetric geometries or offsetting ±1 unit for 
two-dimensional geometries. This orientation is the only one permitted for axisymmetric and 
t wo- dimensional f 1 o w s . 

A representative three-dimensional surface grid (k — 1) is presented in figure 1 1.2. The j — 1 
plane defines the upper (leeside) plane of symmetry. The j — jblk plane defines the lower 
(windside) plane of symmetry. The i = 1 index defines the axis and increases from there toward 
the outflow boundary at i — iblk n bu 

The two examples presented above contain an axis singularity (cell wall with zero area). 
Ci rids can be created which remove the singularity at the nose at the expense of creating skewed 
cells on the outflow boundary. A representative, singularity free surface grid for a blunted 
geometry is presented in figures 11.3 to 11.5. In this example, the j = 1 plane defines the plane 
of symmetry. The j = jblk nh ^ plane defines the outflow boundary from approximately 45 deg to 
135 deg around the center of the base (fig. 11.4). The i = 1 plane defines the outflow boundary 
from the symmetry plane (0 deg) to the beginning of the j = jblk nhUi . plane. The i — iblk 
plane defines the outflow boundary from the end of the j = jblk nhik plane to the symmetry plane 






x, in. 

figure 11-1. Projection of singularity free surface grid over blunt body on .((/-plane 



-100 -50 0 50 

x, in. 

l iguie 11.4. Projection of singularity free surface grid over blunt body on ,r ~- plane. 

ISO deg around the base. The surface grid cells on the outflow boundary at the 45- deg and 
ldo-deg locations appear triangular. (See the inset of fig. 11.4.) In fact, one face is composed of 
two families of coordinate lines. 


11.1.1. Boundary-Layer and Shock Grid Adaption 

Resolution of the captured bow shock is required to evaluate the influence of thermochem- 
ical nonequilibrium on radiative heating. Bow-shock resolution is potentially as important to 
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Figure 11.5. Singularity free surface grid over blunt body. 

accurate radiative heating predictions as boundary-layer resolution is to convective heating pre- 
dictions. Consequently, a simple algebraic grid adaption routine is used to distribute computa- 
tional cells across the shock layer according to four quantities ( ncdl w , fstr . epO, and fsh) which 
are discussed below. 

First, the cell size at the body is set to yield a specified cell Reynolds number ( reall w ) where 


recrll = 


pa As 


k 


and As is the cell height . Second, the fraction of cells available for boundary-layer resolution fstr 
is specified. Third, the concentration of cells at the shock front is controlled with the parameter 
C p0. Fourth, the outer boundary is adjusted to force the location of the captured shock in 
physical space to lie at a constant fraction fsh of the length of the (.-coordinate line extending 
from the body, across the boundary layer and shock, and to the free-stream inflow boundary. 
The shock location is defined by the first point with a local property that exceeds its free-stream 
value by a. specified amount. 

Let s [ ' ] (k) denote the present (superscript [1]) arc length from the body surface to the kth 
cell center along a (.'-coordinate line defined by K cells, where k < K. For simplicity, we drop 
the i,j subscripts in subsequent notation, but keep in mind that this procedure is followed for 
each (, -coordinate line. Let 


denote the nondimensional length of the adapted grid (superscript [2]) along the (.'-coordinate 
line, and let 

As( k ) = s ( k + ) — s ( k - ) 


where 

A:+ = k + - and 

The fractional values ( k ± \ ) refer to cell edges. 


A-_ 


= k - 


1 

2 
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First , a transformation to resolve the boundary layer is defined. Define the nondimensional 
height of the first cell by 


A*(l) = 


rcctll w (i\ 1 ' 


p( f)«(l )*[■]( A') 

The height of the next kstr cells ( kstr = fair 1<) is defined by 


11 . 1 ) 


A.s{ k) = min < 


/[/,■- 1 ] 7T 

1+ < 

1 — ( A - ) 

K + 1 - k 


A.s( k I 


1 . 2 ) 


where 


C = 


Mr 


LA.s( 1 


1 

kstr 


.3) 


This function provides a coll growl h factor of I at k = I anti * = fa.fr a.itl a maxitmm, growth 
factor equal to 1 + C at k = kstr/ 2. It also precludes the nondimensional arc length M* + ) 
from exceeding 1 by limiting the continued application of cell growth factors, if necessary. The 
remaining cells extending past k — kstr are equally spaced, thus 

A .if A) = A.if k - 1) 


for k > kstr. The distribution in .5 is obtained by summation. 


(/■ + ) ---!>;(/) 


II. 


t=i 


The stretching function defined above is designed to yield a value of s{h + ) - 0( 1 ) with con- 
tinuous first, derivatives of the cell growt h factor. An additional renormalization. 

* ( A- + ) 


•i ( k + ) — 


s(K. 


forces the distribution to span 0 and 1 even when the -s(A’ + ) < 1. 

NOTE: This renormalization will increase the effective cell Reynolds number, pos- 
sibly beyond the range where boundary-layer resolution is adequate for heat transfer 
predictions. A warning message is written to standard output when the criteria for 
ifc(ll w is not satisfied. Cell Reynolds number information along the body is located 
in output file grid. out. which is created by vrapup.F. Values of retell across the 
entire shock laver also can be viewed in the column labeled “Re.cell” of the output 
generated by outputa.F. This routine is not generally called, but can be engaged by 
removing the comment from the call statement in wrapup.F. 

NOTE: Users should rely on grid refinement studies as the primary tool for evalu- 
ating resolution quality. 

A second transformation to s(k + ) is designed to pull points toward the .5 = fsh location to 
resolve the shock front 

s(k + ) = [1 - cp(k + )}s(k + ) + fslup(k + ) ( ,1 - r ») 
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where 


tp(k+) -.s 2 (A - + )[1 -.s (k + )]epO ( 11 . 6 ) 

The weighting here is designed to give very little change in the near-wall grid distribution and 
preserve the domain 0 < s < 1 . Because s 2 << s when s is close to 0 (near the wall), the 
value of ep is also very small, and the grid in the near wall region is hardly disturbed by this 
new mapping. In a similar manner, grid points near the inflow boundary (where » is close to 
1) are also protected from large movements by keeping the value of ep small with the factor 
[1 — .s(A+)]. The magnitude of epO is limited to keep the grid from folding back over itself in 
the vicinity of fsh as mesh points are mapped into this region. 

The third and final transformation returns dimensionality to the distribution. A scale factor 
is applied which adjusts the outer boundary such that the captured shock lies a constant fraction 
fsh ol the distance .$ ( A + ) between the body and the outer boundary. Thus, 


(k 


* [ 1 ] (*)*(fc) 

fsh 


(11. i 


where -^ [1] ( * ) is the location on the original grid where the captured shock is first sensed according 
to criteria discussed earlier. 


NOTE: In some cases, it is advantageous t.o adjust the outer boundary to force a 
specified distance between it and the captured shock. A simple redefinition of fsh for 
each coordinate line can accomplish this goal. 

Interpolation and extrapolation are used to map the values of .r j.spj ( k+ )j to 

where x is the vector of the Cartesian coordinates. 7 ^ ^ + 

The shock location keys on the first point in from the free-stream inflow boundary, which 
satisfies the criterion 


fctrjmp X proprty x . - proprty < -lx 10 -,i 


where 


proprty = < 


V 

P 

T 


(jump flag — 1 ) 
(jump flag = 2) 
(jump flag = 3) 


NOTE: Specifying jumpflag = 0 fixes the outer boundary at its current position. 
With both the body surface and the outer grid boundaries fixed, algnshk.F simply 
adjusts the cell distribution between them. 


By default, LAURA uses pressure (p) to determine the shock position. However, limited 
tests discussed in reference 17 indicate that pressure is not always the best choice, and other 
options are provided for the user's convenience through the parameter jumpflag. 

Another option for controlling mesh spacing across the shock layer will be employed when 
the parameter betagrd is set greater than 1. In this case, equations 11.1 to 11.4 are replaced by 
a simpler stretching function defined by 


dM = 1 - 


betagrd 


bz- 1 


bz + 1 


/ betagrd + 1 \ it + - 1 + 
\betagrd — 1 / 
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where 


Figure 11.6. Detail of adapted grid and densit 
resolution of the captured bow shock. 


y contours in symmetry plane that, shows 


enhanced 


Table 11 . 1 . Block Indices 


block 

A 

1 B 

c 

D 

E 

G 

nhlk 

i 

1 2 

3 

4 

5 

0 


The parameters for controlling grid distribution across the shock layer 
algnshk.vars.strt. Default values for LAURA are as follows: 


are defined in 


rffcll,,, = | .0 

jump flay = I 
fctrjmp = 1 .5 

fsh = 0.8 

Mr = 0.5 

betagrd = 0.0 

<p() = 0.0 


These values c 

the LOCALIZE 


an be cha 
command 


nged in a LOCAL copy of algnshk.vars .strt. which can b< 

(appendix K). 


1 created 


using 


NOTE: Since tpO 


0, the default gridding yields no clustering at the shock. 


(i)0- 25 /J7V | ' t0 Sen '^f S,1 ° ck ,ocatlon ’ 111 conjunction with setting nctll w = 1 0 and 
and it- o 8 A 7 re " S ab ° Ut the Sh0( - k )- The values used for that case w^e M = 0 5 

' ' ' A ,epreSe,,tatlVe S nd that employs these mappings is shown in figure 1 1 . 0 . 

11.2. Multiple Computational Blocks 

A computational block is a rectangularly ordered array of cells defining all or „a,t of il 
soluuon do„,a,n. Six computational blocks are permitted in LAURA. Their ciesigna io ' 

LpecUyelv " ^ ,U ’ ^ ^ lvalues of 1. 2.3. 4. 5. mid t 




NOTE: The natural designation of F for the sixth block is already occupied for 

other purposes. 

Rlock to block connections assume simple extensions of the running index. For example the 
Block- to- block = c D _ E G) can bc coincident with the * = 1 plane of any 

i _ iblk n hik plane o tvfv-ABCDEG'X^Y) can be coincident with 

of a ;i: - « ***** .. «>..* 

.» j.- = . ^ ««». **.. •»>• - 

most one boundary. Similar restrictions apply to j- and fc-plane connections. 

Multiple computational I, locks can be used to deline the (low held over co.,||^x R 
rations h many instances the solution can be generated on a blotk-bv-blo k basis, the o 
region is solved first, and the windside and leeside blocks are solved subsequently, rhis ap, m ac 
reduces computational time and memory requirements by a factor of 10 01 mow. " " 

late at the last, outflow plane of one block can be injected into the next downs., earn doth fo, 
initialization. Further details on this approach are found in reference 2K am in appnu ,x 1 , 

The grid alignment capability in LAURA also can be used ... the multi-block n.a chmg 
mode. A single block solution over the nose region can be grid al.gnec m t ie s am ah * ■ ^ 
Grid alignment can be used ill subsequent windside blocks under the speoa (one 

follow : 

1 . Bloch A is a single plane of colls (i«, = 1) taken front the converged upstream block at 
or near its outflow boundary. 

2. Block B defines the windside region to be solved and the inflow plane of Block B coincides 
with the outflow plane of Block A. 

:h Only one active task, which is assigned to Block B exists. 

Boundary conditions for Block B are as follows: 

1. Shared boundary at i = 1 with Block A 

2. Outflow boundary at i = iblk 2 

3. Outflow (sideflow) boundary at j = 1 

4. Plane of symmetry (no yaw) at j = jblk 2 

5. Wall at k = 1 

(>. Free stream at k = kblk 2 

LAURA will assume this roiinguration if »Nocfc.= 2 (in parameter . strt ) and numgnl > 0 fin 

““("rid alignment can he used in subsequent leeside blocks under the following special 
conditions: 

! Block A is a single plane of cells («M-, = 1) taken from the converged upstream block at 
or near its outflow boundary. 

t i c __n«. f ,■;,//■ — n taken from the converged windside block 

2. Block B is a single plane of cells (jblL 2 - l) idxen nom *m- (=> 

bounding the leeside block. 
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:i Block C defines the leeside region to he solved, and the inflow plane of Block C coincides 
with the outflow plane of Block A and the sideflow plane of Block B. 

1. Only one active task, which is assigned to Block C, exists. 

Boundary conditions for Block C are as follows: 

1. Shared boundary at / = 1 with Block A 

2. Out flow boundary at i = iblk.\ 

3. Plane of symmetry (no yaw) at j = 1 

4. Shared sideflow boundary with Block B at j = jblk^ 

b. Wall at k ~ 1 

b. Free stream at k = kblk^ 

LAURA will assume this configuration if nblocks = 3 (in parameter . strt ) and movtyrd > () (in 
data). 

NOTE: Users are cautioned that the very simplified, one-dimensional approach used 
for grid movement can introduce unacceptable grid skewness over complex configu- 
rations. Experienced users may find that it is possible to modify code in algnshk.F 
and/or algnshk_vars . strt to tailor alignment specificat ions and/or block orienta- 
tions to suit their own applications. 

11.3. Sweeping Options 

The relaxation algorithm in LAURA updates the solution in a computational plane using the 
latest available data at neighboring planes and boundaries. For any cell within the computational 
plane, the relaxation process is a Jacobian function with respect to other cells in the plane and 
a tiauss-Seidel function with respect to cells in neighboring planes and boundaries. The global 
solution is obtained by sweeping across the domain, forward and backward, one plane at a time 
until the solution is converged. 

In viscous hypersonic flow problems, the boundary layer is usually the slowest to converge, 
and sweeping strategies that pass across the boundary layer (using optimal viscous relaxation 
factors) provide the best convergence speeds in LAURA (ref. 18). A discussion of the viscous 
relaxation factor ( rfvis) is presented at the end of section 9. 1.3. 2. As noted in section 11.1, the 
body surface is usually defined by the k = 1 plane so that the default sweep direction involves the 
sequential solution of planes. All the FORTRAN parameter definitions made with the execution 
of PRELUDE assume that only A -directional sweeps are required. 

NOTE: In certain advanced applications other sweep directions can be preferred 
(i.e.. body surfaces defined on /- and/or j-planes). This can be most easily accom- 
plished through file assign.tasks (section 9.1.2). In such cases, the value of isjs in 
a LOCAL version of file parameter . strt also can require modification. 

The variable isjs (assigned in parameter, strt) must be greater than or equal to the maxi- 
mum of the products 


[LI x (12+1)] and [(Ll + l)xL2] 
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where LI and L2 are the number of cells in the two directions perpendicular to the sweep 
direction. LAURA compares these values with isjs for each block. If the maximum requirement 
for all blocks is less than isjs, a warning message is issued stating that isjs can be reduced to 
save memory. If any block requires more memory than isjs provides, an error message is issued 
and the job is terminated. In response to this situation, the user can increase the value of isjs, 
recompile with make, and repeat the LAURA execution. Sweeps in the i- and ^-directions can be 
activated by overwriting the default A*- directional sweep in the file assign_tasks, as described 
in the section 1 1.5.2. 

NOTE: If an axisymmetric solution is being calculated, specification of a circum- 
ferential sweeping direction yields a pure- .Jacobian relaxation. 

11.4. Solid-State-Device (SSD) Memory 

The point -implicit relaxation strategy used in LAURA requires calculation of a Jacobian 
matrix at every computational cell. Because of the computational expense of evaluating and 
triangularizing this matrix every sweep, the H '-triangularization required lor subsequent Gauss 
elimination is calculated once and stored (frozen) for njcobian sweeps before being updated. The 
memory overhead (in words) lor this storage is large 

nb locks 

lit <f * Y ( iblk H jblk n kblk„ ) 

n— 1 

and can require the job to be run in a large memory queue with relatively poor turnaround time. 
CRAY computer systems are often equipped with fast, solid-state-device (SSD) memory that 
can be used to reduce the in-core memory requirements for the job. The process is equivalent 
to reading or writing the triangularized Jacobian to a fast disk drive once per solution sweep. 

The SSD can be activated by setting issd — 1 (default: issd — 0) in a LOCAL copy of file 
issd_assn . strt (which can be found in the STRTfiles subdirectory after running PRELUDE). 
The executable will need to be recompiled by running make. 

At this point, the triangularized Jacobian would be written to the disk on the executable 
directory. The working files now need to be assigned to the SSD. On some systems, space will 
need to be reserved in the SSD directory. One may calculate (in words) the required reservation, 
mtmssD* using the formula 

n blocks 

mern$ sd = (^isjs nexj 2 -f 512^ x ^ LMA\ n (H«^) 

n= 1 

where L M A X n is the number of cells in the sweep direction for Block X (A = A, B. C. D, E, 
or G). file values of the other variables can be found in the file parameter . strt. 

NOTE: This reservation includes buffers needed for well-formed I/O and simplifi- 
cations associated with multi-block FORTRAN parameter definition. 

11.4.1. Interactive Jobs 

The reservation for SSD memory in an interactive session is made on the Numerical Aero- 
dynamic Simulation (NAS) facility CRAY C-90 with the command 

^srfs -r A/EGsspMw $FASTDIr) 
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where 


MIX /ssd = int 


rnemssi) 

10 <; 


+ 1 


NOTE: Typically, $FASTDIR is used in conjunction with issd = 1. while $BIGDIR is 
specified for issd = 0. 


The working files are then assigned to the SSD with the command 

^assign -a $FASTDIR/scr80 -s u fort .80^ 

where suffix 8() corresponds to Block A. If additional blocks are active, they would need to be 
assigned similarly, with suffixes 81 through 85 corresponding to Blocks B t hrough G (excluding 
F. recall), respectively. The interactive session can now proceed as usual. When completed, the 
files on $FASTDIR should be removed, and the reservation concluded with the command 

(srfs -rO $FASTDIr) 


11.4.2. Queued Jobs 

The reservation for SSI) memory in a queued job is made on the NAS (’RAY ( ’-90 with the 
command 

(# QSUB -lr 'SFASTDIR, A/A'GssDMw~q 

placed at or near t he beginning of the submit file. The variable MPJGssd was defined in the 
previous subsection. The assignments are made via the following command lines: 


/ v 

/bin/rm -f .asgnf 

setenv FILENV .asgnf 

assign -a $FASTDIR/scr80 -s u fort. 80 

S. J 


which are placed before the command 

(laura < data) 

Again, additional assignment statements are required when additional blocks are active, as- 
discussed in the previous subsection. 

NOTE: LAURA cannot accommodate different sweep directions in the same com- 
putational block when SSI) memory is engaged. 

11.5. Multitasking 

Multitasking in a numerical algorithm refers to the capability of simultaneous (parallel) 
execution of different pieces of code on multiple central processing units (CPU's) for the purpose 
of decreasing elapsed wall clock time. The CR AY computers offer two options for multitasking. 

The first option most often exploited by users is labeled microtasking. In FORTRAN codes, 
microtasking works on the "do-loop" level, thus spreading the work within a loop among several 
CPU's. T he microtasking, in its simplest form ( autotasking), can be implemented at compile 
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time with no changes required in the source code. Microtasking works well on the same loops that 
vectorize well, and in some situations (i.e. nested do-loops), compiler directives can he placed 
within the source code to further enhance parallelization and vectorization. (CRAY manuals 
should be consulted for more information on parallelization and vectorization.) LAURA makes 
extensive use of do-loops that can be vectorized and microt asked by the CRAY compiler in this 
wav, although no special compiler directives are added to enhance microtasking. 

NOTE: U sers who wish to invoke autot asking in LAURA on a ('RAY computer 
should add the flag U -Zp” to the list of options for tL FFLAGS v in the file Makefile, 
after running PRELUDE arid before compiling with make. 

The second option for multitasking is labeled macrotasking. Macrotasks can include large 
sections of code that are executed in parallel on multiple CPU's. Macrotasking requires the 
insertion of CRAY specific code to start tasks, synchronize tasks, and stop tasks as required in 
the algorithm. LAURA utilizes macrotasking by assigning pieces of the computational domain 
to individual tasks. Each task gathers and scatters data to a master copy of the solution which is 
saved in a shared memory, global common block. Subroutines are called by each task in parallel; 
consequently, task-specific data to be shared among subroutines are stored in l ’task common’' 
blocks. The point-implicit relaxation used in LAURA makes it unnecessary to synchronize 
tasks after they are created so that very high levels of uninterrupted, parallel processing can be 
achieved. Sacrificing synchronization of tasks also means that the path to a converged solution 
is nondeterministic. Furt her discussion of asynchronous convergence is found in reference IK. 

NOTE: Users are cautioned against invoking both microtasking and macrotasking 
in the same job because more tasks can be created than the number of CPU’s that 
are available, thus creating counterproductive contention among tasks for CPU’s. 

Macrotasking generally achieves higher levels of average concurrent CPU use than micro- 
tasking. However, there is a memory overhead per additional task (in words) approximately 
equal to 

mcmtask — (b2K + 96/i.s + 6 rur/+ 2 neq 2 ^ x isjs (1F9) 

w r here neq is the number of governing equations being solved. This overhead (in words) is larger 
w hen the full Navier-Stokes equations are to be solved ( hjovern — 2): 

mem tas k = ^538 + 98 ns+ finer/ + 2 rnq 2 ^ x isjs (11.10) 


11.5.1. Terminology 

Some definitions are required before describing how r macrotasking can be implemented in 
LAURA. Recall that a computational block is a rectangularly ordered array of cells defining 
all or part of the solution domain. A partition truncates a block in the computational sweep 
direction. For example, the recommended sweep direction starts at the body surface and moves 
across the boundary layer. In the default mode, this extends from k = 1 to k = kblL where kblk 
is the total number of cells in the ^-direction of the active block (chapter 7). In this scenario, a 
A’-partition is defined bv specifying limits on the starting and stopping location of the sweep in 
the fc-direction. An /-partition and a ^-partition are defined similarly, by specifying limits on the 
starting and stopping location of the sweep in the i- and j-directions, respectively. Partitions 
can overlap in any computational block. Transverse sweep directions also can be accommodated. 

NOTE: A maximum of 100 partitions are allowed in LAURA. 
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One or more partitions are assigned to a task. It is convenient to think of a task as being 
assigned to a particular CPU. In practice, tasks get rolled in and out of execut ion in a multiuser 
environment, and there is no guarantee that the same CPU will always process the same task. 

NOTE: A maximum of Hi tasks can be accommodated in LAURA: however, it is 
counterproductive to assign more tasks than available CPU's on the computer. 

11.5.2. Implementation 

At present, macrotasking options exist only for the CRAY computers, and they can be im- 
plemented in two ways. In the default mode, the code assigns one ^'-partition per computational 
block, and each partition is assigned to its own task. As a result, a single block job will not 
macrotask in the default mode. 

I lie user can overwrite the defaults by creating a file called assign-tasks in the executable 
directory. Each line of file assign-tasks defines a partition through the following five flags: 

nkk defines the computational block containing the 

partition ( I = Block A. 2 = B, 3 = C, 

I = D. 5 = E. and (> = G) 

n> l>k defines the sweep direction and partition type 

(I = 2 = j-, and 3 = A'-sweep) 

Istrt defines the starting index of the sweep 

( 1 < Istri < 1st op) 

Istop defines the stopping index of the sweep 

(Istrt < Istop < LMAX) 

mupcpu defines the processor (by number) to which the 
partition is assigned 
(1 < mapepu < rnaxcpu) 


11.5.3. Load Balancing 

1 he user can assign partition sizes and tasks in such a w'ay as to concentrate CPU cycles in 
regions that are slow to converge. An option for dynamic load balancing exists for the case of a 
single block divided into ^-partitions, with each partition assigned to its own task. The option 
can be switched on by setting mtaska = 1 (default: mtuska = 0) in the file mtaska.assn . strt 
after running PRELUDE. The executable will need to be recompiled by running make. The algo- 
rithm will dynamically change partition boundaries by comparing the error norms of adjacent 
partitions, decreasing the size of partitions with large error norms, and increasing the size of 
partitions with small error norms. While some very encouraging results have been obtained in 
test rases (ref. IS), this option is considered to be experimental and is only recommended for 
use by researchers interested in this specific topic. 

Experience in a multiuser environment has shown that multiple tasks do not necessarily get 
equal access to CPU time. Typically, tasks one through four of an eight-CPU machine get nearly 
equal access, while subsequent tasks appear to be penalized, especially during peak load periods. 
It is believed this discrepancy derives from the manner in which the system is tuned to promote 
fair share access to all users. When this unequal access occurs, load balancing is disrupted, and 
CPU cycles can be wasted. Consequently, requests for more than four tasks are not recommended 
for small jobs run during peak activity periods. However, special multitasking queues can be 
created for very large jobs that run at off-peak times in a nearly dedicated, high-priority mode. 
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NOTE: The user should consult the system administrator for information on such 
queues. 

In this mode, our experience shows that all tasks get equal access, and we routinely obtain 
average concurrent CPU use levels of greater than 7 on an 8-processor CRAY Y MP and have 
achieved values greater than 14 ( 15.3, on one occasion in a multitasking queue run at night with 
minimal contention from other users) on a 1C- processor CRAY' C-90. 

NOTE: Multitasking should not be run when the option for grid restructuring is 
active. Grid restructuring requires synchronization of tasks, which is not provided 
for in LAURA. 

NOTE: Setup of the executable using PRELUDE assumes that only Ar-directional 

sweeps are required in setting up dimension statements. Defining /- and j-directional 
sweeps can result in an error message from laura, followed by an abort of the 
job request, if the required array dimensioning exceeds the prescribed value for isjs 
(section 11.3). 

11 ,6. Radiative Transport 

The treatment of radiation phenomena in a high-temperature flow requires a level of effort 
that is a significant fraction of the total effort required to express and solve the fluid equations. 
It is therefore often omitted in CF1) applications. Under certain conditions, however, the effect 
of radiative heating on the flow and the heating of the vehicle surface is not negligible. The 
LORAN (Langley Optimized Radiative Noiiequilibrium) algorithm (ref. *29) has been developed to 
allow LAURA to be applied to this class of problems. In cases in which radiative effects on the 
flow field are minor, LORAN can be used to post-process a LAURA solution. 1 he details of this 
application are given in reference 30. For cases in which radiation significantly alters the flow 
field properties, LORAN may be iteratively coupled to the LAURA algorithm (ref. 31). 


NASA Langley Research Center 
Hampton. VA 23681-0001 
October 10, 1995 
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Appendix A 


Sample Case 


An example case is included here to illustrate an application of the LAURA algorithm. 
This simple case is the axisymmetric flow over a. sphere with a radius of 1 m. The thin-layer 
Navier-Stokes equations are solved for laminar, perfect gas flow. The free-stream conditions 
are - 5000 m/s. = 0.001 kg/m -3 , and 7' x = 200 K. A constant wall temperature of 
T„. = .,00 k is specified. The grid dimensions are 30 cells in the streamwise direction and 01 in 
the body-normal direction. 

h iles from the initial run for this sample case serve as examples throughout, the manual. Files 
from the second run for this sample case are contained in this appendix. The results presented 
for this example can be replicated by creating a working directory and repeating the procedure 
described below. 

Typing the command 

(prelude) 

and accepting the default values for each prompt will yield the initialization of RESTART, in used 
here, as well as the file data shown in section 9.1.3. The file INPUTS is created by PRELUDE and 
is a. record of the responses to the prompts of stArt during the most recent PRELUDE session in 
this LOCAL directory. Its contents for this sample case are shown in section (j.3. For subsequent 
PRELUDE sessions, typing the command 


(prelude inputs) 


yields the initialization of RESTART, in used here, as well as the file data shown in section 9.1.3, 

NOTE: Since a constant wall temperature ( tempbc = 0) is specified, the files 
TWALL . in and transition are not required. Further, the file transition is not 
required for laminar flow. 

The results presented herein are from a SUN Sparcstation with a single processor. No 
assign_tasks file was incorporated. Since it is a simple case, no LOCAL or CUSTOM files were 
required. As mentioned above, the input and output files for the initial run are interspersed 
throughout this manual, and are not repeated here. 

For the second run, PRELUDE does not need to be repeated. The adjustments are accomplished 
through a direct modification to file data. The resultant data file used for the second run is 
shown below (screen 50): 
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2 

20 

9ft 

nord 

ntrnsprt . 

VERSI0N=LAURA .4 . 1 

l(st-) or 2(nd-) order spatial accuracy 

. . . iterations between transport property updates 
iterations between iacobian updates 

0 0 1 

{i, j.kjvis 

. 0=off/l=on for {i,j,k} TL N-S viscous terms in block 1 

cnftftftF+ftd 


freestream velocity [m/s] 

. 10000E-02 

rinfb . . . . 

freestream density [kg/m^] 

freestream temperature [K] 

0 

. 50000E+03 
0.000 

tempbc . . . 

.... {0=constant, l=variable, 2=radiative equilibrium} Tw 
... if tempbc=0 : wall temperature [K] 

ept 

if tempbc=2: temperature relaxation factor (0 < ept < 1) 

1.0000 

ft AAAAAAF+OO 

rflngth . 

... conversion: grid units ==> meters (1 m = 1.0000 m) 

axial eg location [m ] 

U « UUUvvvljTvv 

A AAAAAAF+OO 

zc g 

vertical eg location [m ] 

• uUuvvv L T v 

A ^141^9F+A1 

xc 8 

rpf arpa 

reference area of body [m "2] 

v . O t/L T v 1 

0.200000E+01 

1 “ X CU. Cu « 

ref len . . 

reference length of body [m ] 

i sue 

i T prir 

.... maximum iterations for this run 

200 

4 

AlCi 6 • ■ • 
movegrd . 
maxmoves 
iabseig . 
epsa .... 
^ rr d 

frequency of grid adiustments 

. maximum number of grid adjustments (0—no limit) 

1 

0.300 

0.010 

{0=normal . l=scaled} limiter 

eigenvalue limiter 

error criteria for grid doubling 

1 ft ftft 


time limit for this run [hr] 

IV • V/V 

1.60 

.60 

rfinv . . . 
rfvis . . . 

inviscid relaxation factor, (rfinv > 1.5) 

viscous relaxation factor, (rfvis > 0.5) 


Screen 50. 


A.l. Screen Output 

The constituent elements of the standard output are discussed in section 10.1. That section 
also contains the standard output from the initial run of this sample case. The standard output 
for the second run (excluding the preamble) is shown on the pages which follow, beginning with 
the following iteration record (screen 51): 
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tsk blk ms iter L2 norm tsk norm inf norm 


i j k m time strt stp 


CPU number 01 starting 


1 

1 

3 

20 

1 . 737E-01 

1 . 737E-01 4 . 920E-02 

22 

1 

15 

1 

9.90 

1 

16 

1 

1 

3 

40 

6 . 422E-02 

6.422E-02 2 . 914E-02 

30 

1 

15 

1 

19.31 

1 

16 

1 

1 

3 

60 

1 .680E-02 

1 . 680E-02 1 . 626E-02 

29 

1 

6 

1 

28.87 

1 

16 

1 

1 

3 

80 

7. 106E-03 

7 . 106E-03 1.473E-02 

29 

1 

6 

1 

38.24 

1 

16 



.Grid doubled after 

iter = 80 








1 

1 

3 

100 

3 . 304E-02 

3 . 304E-02 1.841E-02 

2 

1 

1 

1 

57.29 

1 

32 

1 

1 

3 

120 

2.697E-02 

2 . 697E-02 1 . 922E-02 

18 

1 

1 

1 

76.15 

1 

32 

1 

1 

3 

140 

2.167E-02 

2. 167E-02 2 . 068E-02 

27 

1 

1 

1 

95.02 

1 

32 

1 

1 

3 

160 

9 . 398E-03 

9 . 398E-03 1 . 478E-02 

28 

1 

1 

1 

113.90 

1 

32 



.Grid doubled after 

iter » 160 








1 

1 

3 

180 

3.031E-02 

3 . 031E-02 1 . 641E-02 

30 

1 

64 

1 

151.98 

1 

64 

1 

1 

3 

200 

3.173E-02 

3. 173E-02 1 . 440E-02 

5 

1 

1 

1 

189.79 

1 

64 


...Grid adjusted after iter = 200 


WARNING: Recell.w criterion not satisfied in "algnshk" for a total 

of 30 stations (see files "algnshk.out" k "grid, out' 1 ) . 


1 

1 

3 

220 

1 . 087E-01 

1.087E-01 

5.193E-02 

30 

1 

57 

1 

228.12 

1 

64 

1 

1 

3 

240 

5 . 979E-02 

5.979E-02 

4.544E-02 

30 

1 

58 

1 

265.90 

1 

64 

1 

1 

3 

260 

3 . 217E-02 

3 . 2 17E-02 

3 . 932E-02 

30 

1 

59 

1 

303.71 

1 

64 

1 

1 

3 

280 

1 . 342E-02 

1.342E-02 

1 . 963E-02 

30 

1 

59 

1 

341.52 

1 

64 

1 

1 

3 

300 

7.762E-03 

7 . 762E-03 

1 . 314E-02 

30 

1 

60 

1 

379.33 

1 

64 

1 

1 

3 

320 

5 . 779E-03 

5 . 779E-03 

9.356E-03 

21 

1 

56 

1 

417.29 

1 

64 

1 

1 

3 

340 

3 . 557E-03 

3 . 557E-03 

7 . 935E-03 

27 

1 

59 

1 

455.12 

1 

64 

1 

1 

3 

360 

1 . 342E-03 

1 . 342E-03 

4 . 642E-03 

30 

1 

61 

1 

492.97 

1 

64 

1 

1 

3 

380 

6.612E-04 

6 . 612E-04 

2 . 131E-03 

28 

1 

55 

1 

530.79 

1 

64 

1 

1 

3 

400 

5 . 078E-04 

5 . 078E-04 

2. 195E-03 

24 

1 

22 

1 

568.64 

1 

64 


...Grid adjusted after iter = 400 

WARNING: Recell_w criterion not satisfied in "algnshk" for a total 

of 30 stations (see files "algnshk.out" k "grid. out"). 


Screen 51. 

NOTE: The frequency of output for the iteration record is controlled by the param- 
eter njcobian. In other words, output is produced only for those iterations in which 
the Jacobian is updated. For the initial run, the update occurred for each iteration. 
For the second run, however, the solution advances 20 iterations (screen 52) between 
updates (as specified in file data). 
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1 

1 

3 

420 

6 . 391E-03 6 . 391E-03 1.384E-02 

23 

1 

55 

1 

607.02 

1 

64 

1 

1 

3 

440 

3 . 742E-03 3 . 742E-03 1.216E-02 

25 

1 

55 

1 

644 . 82 

1 

64 

1 

1 

3 

460 

2 . 631E-03 2 . 631E-03 1.041E-02 

27 

1 

55 

1 

682.61 

1 

64 

1 

1 

3 

480 

1 . 252E-03 1 . 252E-03 5.933E-03 

30 

1 

55 

1 

720.36 

1 

64 | 

1 

1 

3 

500 

4 . 885E-04 4 . 885E-04 2.682E-03 

30 

1 

21 

1 

758.14 

1 

64 

1 

1 

3 

520 

3 . 697E-04 3 . 697E-04 3.167E-03 

25 

1 

56 

1 

795.94 

1 

64 

1 

1 

3 

540 

3 . 619E-04 3 . 619E-04 4.036E-03 

26 

1 

55 

1 

833.75 

1 

64 

1 

1 

3 

560 

4 . 726E-04 4 . 726E-04 4.521E-03 

28 

1 

55 

1 

871.52 

1 

64 

1 

1 

3 

580 

4 . 010E-04 4.010E-04 4.339E-03 

28 

1 

55 

1 

909.32 

1 

64 

1 

1 

3 

600 

1 . 697E-04 1.697E-04 3.490E-03 

30 

1 

55 

1 

947.08 

1 

64 



.Grid adjusted after iter = 600 










WARNING: 

Recell_w criterion not satisfied 

in " 

algnshk 

" for a total 






of 30 stations (see files "algnshk, 

. out M 

ft 

"grid. out"). 


1 

1 

3 

620 

5.297E-03 5.297E-03 1.710E-02 

27 

1 

55 

1 

985.40 

1 

64 

1 

1 

3 

640 

2.632E-03 2 . 632E-03 1 . 246E-02 

29 

1 

55 

1 

1023.18 

1 

64 

1 

1 

3 

660 

9 . 894E-04 9 . 894E-04 6.683E-03 

30 

1 

55 

1 

1060.89 

1 

64 

1 

1 

3 

680 

4.246E-04 4.246E-04 3.904E-03 

30 

1 

54 

1 

1098.69 

1 

64 

1 

1 

3 

700 

2 . 298E-04 2.298E-04 2.218E-03 

21 

1 

55 

1 

1136.46 

1 

64 

1 

1 

3 

720 

1 . 804E-04 1 . 804E-04 1.619E-03 

21 

1 

55 

1 

1174.19 

1 

64 

1 

1 

3 

740 

1 . 579E-04 1.579E-04 2.185E-03 

18 

1 

55 

1 

1211.99 

1 

64 

1 

1 

3 

760 

1 . 261E-04 1 . 261E-04 2.283E-03 

19 

1 

55 

1 

1249.73 

1 

64 

1 

1 

3 

780 

1 . 067E-04 1 . 067E-04 2.039E-03 

21 

1 

55 

1 

1287.47 

1 

64 

1 

1 

3 

800 

1 . 097E-04 1.097E-04 2.090E-03 

22 

1 

55 

1 

1325.25 

1 

64 



.Grid adjusted after iter = 800 










WARNING: 

Recell_w criterion not satisfied 

in " 

algnshk 

" for a total 






of 30 stations (see files M 

algnshk 

.out" 

ft 

"grid. out' 





.Turning off algnshk after 4 adjustments 







1 

1 

3 

820 

5 . 234E-03 5 . 234E-03 2.106E-02 

24 

1 

55 

1 

1363.52 

1 

64 

1 

1 

3 

840 

3 . 289E-03 3 . 289E-03 1 . 342E-02 

26 

1 

55 

1 

1401.31 

1 

64 

1 

1 

3 

860 

2 . 175E-03 2 . 175E-03 1.147E-02 

28 

1 

55 

1 

1439.11 

1 

64 

1 

1 

3 

880 

9 . 456E-04 9.456E-04 8.215E-03 

30 

1 

55 

1 

1476.84 

1 

64 

1 

1 

3 

900 

3 . 577E-04 3 . 577E-04 3.293E-03 

30 

1 

55 

1 

1514.61 

1 

64 

1 

1 

3 

920 

2 . 364E-04 2 . 364E-04 1.992E-03 

25 

1 

55 

1 

1552.35 

1 

64 

1 

1 

3 

940 

2 . 007E-04 2 . 007E-04 2.386E-03 

27 

1 

55 

1 

1590.09 

1 

64 

1 

1 

3 

960 

1 . 364E-04 1.364E-04 1.924E-03 

20 

1 

56 

1 

1627.85 

1 

64 

1 

1 

3 

980 

1 . 038E-04 1.038E-04 1.916E-03 

18 

1 

55 

1 

1665.68 

1 

64 

1 

1 

3 

1000 

1 . 142E-04 1 . 142E-04 2.600E-03 

21 

1 

56 

1 

1703.47 

1 

64 


Screen 52. 
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1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 


3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 

3 


1020 

1040 

1060 

1080 

1100 

1120 

1140 

1160 

1180 

1200 

1220 

1240 

1260 

1280 

1300 

1320 

1340 

1360 

1380 

1400 

1420 

1440 

1460 

1480 

1500 


8.953E 

6.536E 

3.570E 

2.335E 

1.438E 

1.146E 

7.489E 

4.472E- 

2.943E- 

2.687E- 

2.376E- 

2.218E- 

2.234E- 

2. 121E- 

1.961E- 

1.818E- 

1 . 73 IE 

1.669E 

1.605E 

1.569E- 

1 .725E- 

2.098E- 

3. 145E- 

5.455E- 

6.254E 


:-05 8 . 953E-05 1 
:-05 6.536E-05 1 

05 3 . 570E-05 1 
'”05 2 . 335E-05 1 
-05 1 . 438E-05 5 
-05 1.146E-05 5 
-06 7 . 489E-06 4 
■06 4.472E-06 2 

06 2.943E-06 2 
-06 2 . 687E-06 1 
-06 2.376E-06 1 
-06 2 - 218E-06 1 
-06 2. 234E-06 1 
-06 2. 121E-06 1 
-06 1.961E-06 1, 
-06 1.818E-06 1. 
-06 1.731E-06 1. 
■06 1.669E-06 1. 
■06 1 . 605E-06 1. 
06 1.569E-06 1. 
06 1.725E-06 3. 
06 2.098E-06 5. 
06 3. 145E-06 7. 
06 5 . 455E-06 1. 
06 6 . 254E-06 1. 


. 570E-03 
•556E-03 
.027E-03 
. 075E-03 
•557E-04 
. 525E-04 
. 855E-04 
. 975E-04 
. 075E-04 
. 876E-04 
.661E-04 
. 556E-04 
•579E-04 
. 525E-04 
. 33 IE-04 
. 193E-04 
. 177E-04 
. 165E-04 
143E-04 
159E-04 
111E-04 
100E-04 
075E-04 
044E-03 
258E-03 


25 

1 

55 

1 

1741.34 

1 

64 

27 

1 

55 

1 

1779.16 

1 

64 

28 

1 

55 

1 

1816.92 

1 

64 

18 

1 

56 

1 

1854.69 

1 

64 

28 

1 

55 

1 

1892.42 

1 

64 

28 

1 

55 

1 

1930.19 

1 

64 

30 

1 

55 

1 

1967.91 

1 

64 

30 

1 

55 

1 

2005.71 

1 

64 

18 

1 

55 

1 

2043.49 

1 

64 

18 

1 

55 

1 

2081.23 

1 

64 

18 

1 

55 

1 

2118.99 

1 

64 

22 

1 

55 

1 

2156.81 

1 

64 

23 

1 

55 

1 

2194.51 

1 

64 

26 

1 

55 

1 

2232.27 

1 

64 

28 

1 

55 

1 

2270.04 

1 

64 

28 

1 

55 

1 

2307.80 

1 

64 

15 

1 

55 

1 

2345.58 

1 

64 

15 

1 

55 

1 

2383.34 

1 

64 

15 

1 

55 

1 

2421.25 

1 

64 

21 

1 

56 

1 

2459.11 

1 

64 

21 

1 

56 

1 

2496.90 

1 

64 

21 

1 

56 

1 

2534.65 

1 

64 

21 

1 

56 

4 

2572.44 

1 

64 

21 

1 

56 

4 

2610.22 

1 

64 

21 

1 

56 

4 

2648.03 

1 

64 


CPU 1 terminated at 2648.08 seconds (after 1500 iterations). 


Screen 52. Concluded. 


The integrated surface quantities for this second run are as follows 


(screen 55): 


cx = 

0. 99331755E-02 

cy = 

O.OOOOOOOOE+OO 

CZ SS 

0. 12230405E-01 

gy = 

-0 . 50450885E-02 

summdot * 

-0. 673764 19E-07 

sumheat = 

-0 . 27692626E-03 


Screen 53. 
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A. 2 . File algnshk.out 


The constituent elements of file algnshk.out are discussed in section 
shows the contents of this file from the initial run of this sample case, 
for the second run on the pages that follow (screen o4). 


10.2. That section also 
Its contents are shown 


. . .Grid adjusted after iter - 


i 

j 

hminl 

norm, 
dist . 

1 

1 

. 2290770E-05 

.300507 

2 

1 

. 2246804E-05 

.298642 

3 

1 

. 2228229E-05 

.297847 

4 

1 

. 2231236E-05 

.297976 

5 

1 

. 2254972E-05 

.298990 

6 

1 

. 2317622E-05 

.301634 

7 

1 

.2418150E-05 

.305778 

8 

1 

. 2550057E-05 

.311046 

9 

1 

.2711846E-05 

.317265 

10 

1 

. 2894426E-05 

.323996 

11 

1 

. 3057070E-05 

.329760 

12 

1 

. 3195636E-05 

.334511 

13 

1 

. 3383573E-05 

.340744 

14 

1 

. 3653929E-05 

.349320 

15 

1 

. 3977254E-05 

.359043 

16 

1 

.4367052E-05 

.370094 

17 

1 

.4820189E-05 

.382152 

18 

1 

. 5307045E-05 

.394301 

19 

1 

. 5822294E-05 

.406384 

20 

1 

. 6406782E-05 

.419266 

21 

1 

. 7086295E-05 

.433308 

22 

1 

. 7877459E-05 

.448583 

23 

1 

. 8809709E-05 

.465340 

24 

1 

. 9902239E-05 

.483560 

25 

1 

. 1117809E-04 

.503242 

26 

1 

. 1265588E-04 

.524281 

27 

1 

. 14404 14E-04 

.547192 

28 

1 

. 1664086E-04 

.574000 

29 

1 

. 1975544E-04 

.607668 

30 

1 

. 2242953E-04 

.633914 


200 

wall max. location of 

stretch stretch maximum 

1.045911 1.468397 .001765 (17) 

1.045998 1.469286 .001751 (17) 

1.046035 1.469667 .001746 (17) 

1.046029 1.469605 .001747 (17) 

1.045982 1.469120 .001754 (17) 

1.045859 1.467862 .001773 (17) 

1.045668 1.465916 .001803 (17) 

1.045429 1.463485 .001841 (17) 

1.045154 1.460674 .001886 (17) 

1.044863 1.457703 .001934 (17) 

1.044619 1.455215 .001977 (17) 

1.044421 1.453200 .002011 (17) 

1.044167 1.450607 .002057 (17) 

1.043826 1.447127 .002120 (17) 

1.043451 1.443297 .002192 (17) 

1.043038 1.439087 .002275 (17) 

1.042603 1.434654 .002365 (17) 

1.042181 1.430346 .002457 (17) 

1.041776 1.426211 .002549 (17) 

1.041359 1.421953 .002648 (17) 

1.040920 1.417481 .002756 (17) 

1.040462 1.412800 .002874 (17) 

1.039978 1.407871 .003005 (17) 

1.039475 1.402737 .003148 (17) 

1.038955 1.397434 .003304 (17) 

1.038425 1.392022 .003472 (17) 

1.037874 1.386405 .003657 (17) 

1.037263 1.380165 .003874 (17) 

1.036539 1.372785 .004151 (17) 

1.036007 1.367350 .004368 (17) 


Screen 54. 
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. . .Grid adjusted after iter = 400 





norm. 

wall 

max . 

location of 

i 

j 

hminl 

dist . 

stretch 

stretch 

maximum 

1 

1 

. 24 16946E-05 

.305729 

1.045670 

1.465938 

.001802 

(17) 

2 

1 

. 2408198E-05 

.305373 

1.045686 

1.466105 

.001800 

(17) 

3 

1 

. 2430496E-05 

.306279 

1.045645 

1.465682 

.001806 

(17) 

4 

1 

. 2472090E-05 

.307954 

1.045569 

1.464905 

.001818 

(17) 

5 

1 

. 2509823E-05 

.309459 

1.045501 

1.464212 

.001829 

(17) 

6 

1 

. 2553366E-05 

.311175 

1.045424 

1.463425 

.001841 

(17) 

7 

1 

. 2607570E-05 

.313285 

1.045329 

1.462465 

.001857 

(17) 

8 

1 

. 2660392E-05 

.315314 

1.045240 

1.461549 

.001871 

(17) 

9 

1 

. 2747521E-05 

.318604 

1.045095 

1.460078 

.001895 

(17) 

10 

1 

.2874395E-05 

.323272 

1.044894 

1.458019 

.001929 

(17) 

11 

1 

.3007800E-05 

.328036 

1.044691 

1.455954 

.001964 

(17) 

12 

1 

. 3 136876E-05 

.332513 

1.044504 

1.454043 

.001997 

(17) 

13 

1 

. 3253230E-05 

.336447 

1.044342 

1.452389 

.002026 

(17) 

14 

1 

. 34 17432E-05 

.341842 

1.044123 

1.450156 

.002065 

(17) 

15 

1 

. 36 15713E-05 

.348134 

1.043873 

1.447602 

.002112 

(17) 

16 

1 

. 3819755E-05 

.354374 

1.043630 

1.445121 

.002158 

(17) 

17 

1 

. 4083910E-05 

.362135 

1.043334 

1.442104 

.002216 

(17) 

18 

1 

. 4412589E-05 

.371342 

1.042992 

1.438620 

.002284 

(17) 

19 

1 

. 47491 12E-05 

.380311 

1.042669 

1,435320 

.002352 

(17) 

20 

1 

. 5142228E-05 

.390274 

1.042320 

1.431757 

.002427 

(17) 

21 

1 

. 5639128E-05 

.402172 

1.041916 

1.427636 

.002517 

(17) 

22 

1 

. 625791 IE-05 

.416061 

1.041461 

1.422998 

.002623 

(17) 

23 

1 

. 699277 IE-05 

.431429 

1.040978 

1.418069 

.002741 

(17) 

24 

1 

.7835977E-05 

.447807 

1.040484 

1.413033 

.002868 

(17) 

25 

1 

. 8794738E-05 

.465080 

1.039986 

1.407946 

.003003 

(17) 

26 

1 

. 987 1012E-05 

.483058 

1.039489 

1.402875 

.003144 

(17) 

27 

1 

. 1 1 10448E-04 

.502147 

1.038984 

1.397723 

.003295 

(17) 

28 

1 

. 1262878E-04 

.523910 

1.038434 

1.392115 

.003469 

(17) 

29 

1 

. 1465093E-04 

.550279 

1.037802 

1.385669 

.003682 

(17) 

30 

1 

. 1654355E-04 

.572884 

1.037287 

1.380418 

.003865 

(17) 


Screen 54. Continued. 
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. . .Grid adjusted after iter 35 600 





norm . 

wall 

max. 

location of 

i 

j 

hminl 

dist . 

stretch 

stretch 

maximum 

1 

1 

. 237 1600E-05 

.303874 

1.045755 

1.466806 

.001789 

(17) 

2 

1 

. 2382643E-05 

.304327 

1.045734 

1.466593 

.001792 

(17) 

3 

1 

. 2399836E-05 

.305032 

1.045702 

1.466264 

.001797 

(17) 

4 

1 

. 2422148E-05 

.305940 

1.045660 

1.465840 

.001804 

(17) 

5 

1 

. 2455893E-05 

.307305 

1.045598 

1.465206 

.001814 

(17) 

6 

1 

. 2499914E-05 

.309064 

1.045519 

1.464393 

.001826 

(17) 

7 

1 

.2560883E-05 

.311470 

1.045410 

1.463291 

.001844 

(17) 

8 

1 

. 2623653E-05 

.313906 

1.045302 

1.462184 

.001861 

(17) 

9 

1 

. 2697156E-05 

.316711 

1.045178 

1.460922 

.001882 

(17) 

10 

1 

. 2798099E-05 

.320481 

1.045014 

1.459245 

.001909 

(17) 

11 

1 

. 29 14756E-05 

.324729 

1.044832 

1.457384 

.001940 

(17) 

12 

1 

. 3043477E-05 

.329286 

1.044639 

1.455417 

.001973 

(17) 

13 

1 

. 3176427E-05 

.333861 

1 . 044448 

1.453474 

.002007 

(17) 

14 

1 

. 333 125 IE-05 

.339032 

1.044237 

1.451314 

.002045 

(17) 

15 

1 

. 3516904E-05 

.345028 

1.043996 

1.448856 

.002089 

(17) 

16 

1 

. 3728334E-05 

.351607 

1.043737 

1.446215 

.002137 

(17) 

17 

1 

. 3966779E-05 

.358736 

1.043462 

1.443416 

.002190 

(17) 

18 

1 

. 4261349E-05 

.367164 

1.043146 

1.440189 

.002253 

(17) 

19 

1 

. 4593823E-05 

.376227 

1.042815 

1.436812 

.002321 

(17) 

20 

1 

. 4930324E-05 

. 384968 

1.042504 

1.433641 

.002387 

(17) 

21 

1 

. 5328680E-05 

. 394824 

1.042163 

1.430164 

.002461 

(17) 

22 

1 

.5795001E-05 

.405761 

1.041796 

1.426420 

.002544 

(17) 

23 

1 

. 6345261E-05 

.417948 

1.041401 

1.422382 

.002637 

(17) 

24 

1 

. 6983392E-05 

.431239 

1.040984 

1.418129 

.002740 

(17) 

25 

1 

. 7737298E-05 

.445953 

1.040539 

1.413593 

.002854 

(17) 

26 

1 

.8585244E-05 

.461415 

1.040090 

1.409007 

.002974 

(17) 

27 

1 

. 9535036E-05 

.477589 

1.039638 

1.404394 

.003101 

(17) 

28 

1 

. 1070106E-04 

.496063 

1.039142 

1.399340 

.003247 

(17) 

29 

1 

. 1226339E-04 

.518857 

1.038559 

1.393393 

.003429 

(17) 

30 

1 

. 1372809E-04 

.538561 

1.038079 

1 . 388489 

.003587 

(17) 
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. 

. .Grid adjusted alter iter = 

800 







norm . 

wall 

max . 

location of 

i 

j 

hminl 

dist . 

stretch 

stretch 

maximum 

1 

1 

. 2375307E-05 

304026 

1.045748 

1.466735 

.001790 

(17) 

2 

1 

. 2388167E-05 

304554 

1.045724 

1.466487 

.001794 

(17) 

3 

1 

. 241 1492E-05 

305507 

1.045680 

1.466042 

.001801 

(17) 

4 

1 

. 2436916E-05 

.306539 

1.045633 

1.465562 

.001808 

(17) 

5 

1 

. 2470399E-05 

.307886 

1.045572 

1.464937 

.001818 

(17) 

6 

1 

. 25 15616E-05 

309688 

1.045490 

1.464107 

.001831 

(17) 

7 

1 

. 2574941E-05 

312019 

1.045386 

1.463040 

.001848 

(17) 

8 

1 

. 2639533E-05 

314516 

1.045275 

1.461908 

.001866 

(17) 

9 

1 

. 2708183E-05 

317128 

1.045160 

1.460736 

.001885 

(17) 

10 

1 

. 2781 182E-05 

.319857 

1.045041 

1.459522 

.001904 

(17) 

11 

1 

. 2871940E-05 

.323184 

1.044898 

1.458058 

.001929 

(17) 

12 

1 

. 3009501E-05 

.328095 

1.044689 

1.455928 

.001964 

(17) 

13 

1 

. 3178134E-05 

.333919 

1.044446 

1.453449 

.002007 

(17) 

14 

1 

. 3350795E-05 

.339674 

1.044210 

1.451048 

.002049 

(17) 

15 

1 

. 3535329E-05 

.345611 

1.043972 

1.448620 

.002093 

(17) 

16 

1 

. 3749227E-05 

.352243 

1.043712 

1.445963 

.002142 

(17) 

17 

1 

. 3987594E-05 

.359345 

1.043439 

1.443180 

.002195 

(17) 

18 

1 

. 4253068E-05 

.366932 

1.043155 

1.440277 

.002251 

(17) 

19 

1 

. 4578935E-05 

.375830 

1.042829 

1.436957 

.002318 

(17) 

20 

1 

. 4962142E-05 

.385774 

1.042476 

1.433353 

.002393 

(17) 

21 

1 

. 5374729E-05 

.395931 

1.042126 

1.429780 

.002470 

(17) 

22 

1 

. 581482 IE-05 

.406213 

1.041782 

1.426268 

.002548 

(17) 

23 

1 

. 6326546E-05 

.417545 

1.041414 

1.422513 

.002634 

(17) 

24 

1 

. 6914565E-05 

.429846 

1.041027 

1.418568 

.002729 

(17) 

25 

1 

. 7596157E-05 

.443273 

1.040619 

1.414407 

.002833 

(17) 

26 

1 

. 8388739E-05 

.457924 

1.040190 

1.410027 

.002947 

(17) 

27 

1 

. 9304709E-05 

.473769 

1.039743 

1.405468 

.003071 

(17) 

28 

1 

. 1044293E-04 

.492094 

1.039247 

1.400408 

.003216 

(17) 

29 

1 

. 1198605E-04 

.514955 

1.038657 

1,394390 

.003397 

(17) 

30 

1 

. 1344289E-04 

.534835 

1.038168 

1.389400 

.003557 

(17) 
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A. 3. File conv. out 


The constituent elements of file conv. out are discussed in section 10.3. That section also 
shows the contents of this file from the initial run of this sample case. Its contents are shown 
for the second run (screen 55): 


body pressure 

tsk iter residual time (sec) (stag) (end) 


body heating 
(stag) (end) 


1 20 . 173680E+00 
1 40 . 642220E-0 1 
1 60 . 167974E-01 
1 80 . 7 10615E-02 
1 100 . 330401E-0 1 
1 120 .269717E-01 
1 140 . 216679E-01 
1 160 . 93981 IE-02 
1 180 . 303121E-01 
1 200 . 317269E-01 
1 220 . 108663E+00 
1 240 . 597945E-0 1 
1 260 . 321750E-01 
1 280 . 134248E-01 
1 300 . 776205E-02 
1 320 . 577924E-02 
1 340 . 3557 17E-02 
1 360 . 134166E-02 
1 380 . 661229E-03 
1 400 . 507751E-03 
1 420 . 639128E-02 
1 440 . 374177E-02 
1 460 . 263072E-02 
1 480 . 125234E-02 
1 500 . 488538E-03 
1 520 . 369721E-03 
1 540 . 361910E-03 
1 560 .47261 IE-03 
1 580 . 401026E-03 
1 600 . 169720E-03 
1 620 . 529670E-02 
1 640 . 263227E-02 
1 660 . 989424E-03 
1 680 .424563E-03 
1 700 . 229767E-03 
1 720 . 180376E-03 
1 740 . 157903E-03 
1 760 . 126059E-03 
1 780 . 1067 14E-03 
1 800 . 109687E-03 


9.480 1.02787 
18.890 .930974 
28.450 .925715 
37.820 .923494 
56.870 .958593 
75.730 .891812 
94.600 .928096 

113.480 .923566 
151.560 .924323 

189.370 .989561 

227.700 .932868 

265.480 .900657 
303.290 .921168 

341.100 .911631 
378.910 .922587 
416.870 .924712 

454.700 .921260 
492.550 .922012 

530.370 .922229 
568.220 .922666 
606.600 .922256 
644.400 .932637 
682.190 .921975 
719.940 .912888 
757.720 .918442 
795.520 .922170 
833.330 .924905 

871.100 .922862 
908.900 .920210 
946.660 .919402 
984.980 .919623 

1022.760 .920270 
1060.470 .915966 
1098.270 .919373 
1136.040 .920236 
1173.770 .919915 
1211.570 .919846 
1249.310 .919509 
1287.050 .919529 
1324.830 .919393 


. 36281 IE-01 
. 343741E-01 
. 352460E-01 
. 342261E-01 
. 360259E-01 
. 337655E-0 1 
. 344724E-01 
. 375377E-01 
.350256E-01 
.340480E-01 
. 344543E-01 
. 353153E-01 
. 356246E-01 
. 397506E-01 
. 356448E-01 
. 359903E-01 
. 374134E-01 
. 378405E-01 
. 378553E-01 
. 377 150E-01 
. 377506E-01 
. 386944E-01 
. 386469E-01 
.380557E-01 
. 387008E-01 
. 3855 19E-01 
. 380903E-01 
. 380120E-01 
. 380712E-0 1 
. 380940E-01 
. 3801 17E-01 
. 382168E-01 
. 384135E-01 
. 383122E-01 
. 380983E-01 
. 383076E-01 
. 383422E-01 
. 382220E-01 
. 381634E-01 
. 383610E-01 


- . 207159E-01 
168117E-01 
152770E-01 
- . 146595E-01 
- . 148522E-01 
-. 121135E-01 
- . 125548E-01 
- . 122950E-01 
- . 118011E-01 
135799E-01 
- . 978973E-02 
- . 985254E-02 
-.996108E-02 
- . 968400E-02 
- . 978836E-02 
- . 970618E-02 
- .956439E-02 
- . 950948E-02 
- . 944654E-02 
- . 939521E-02 
- . 880919E-02 
-.904346E-02 
- . 867947E-02 
- . 857411E-02 
- . 863178E-02 
- . 866181E-02 
- . 866811E-02 
- . 859700E-02 
- . 852818E-02 
- . 849003E-02 
* . 859598E-02 
- .856932E-02 
- . 847342E-02 
- . 851422E-02 
- . 849428E-02 
- . 846965E-02 
-. 84463 IE-02 
- . 842193E-02 
- . 840353E-02 
- . 838295E-02 


181072E-02 
- . 148686E-02 
- . 127062E-02 
- . 101474E-02 
- . 902765E-03 
- . 697635E-03 
- . 627335E-03 
- . 649356E-03 
54665 IE-03 
- . 501591E-03 
“ .453082E-03 
- . 466547E-03 
“ . 477 142E-03 
- . 554359E-03 
-.455140E-03 
- . 472353E-03 
- . 499765E-03 
- . 503842E-03 
- . 500433E-03 
- .49507 IE-03 
- . 508537E-03 
~ . 523425E-03 
- . 513020E-03 
“ . 495906E-03 
- . 512426E-03 
-.499670E-03 
-.488361E-03 
- . 485701E-03 
- . 485206E-03 
- . 484321E-03 
- . 534466E-03 
- . 537372E-03 
- . 538888E-03 
- . 533952E-03 
- . 528916E-03 
- . 534570E-03 
- . 534464E-03 
- . 5317 12E-03 
- . 531835E-03 
- . 537666E-03 
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1 820 . 523377E-02 1363.100 .919520 
1 840 . 328934E-02 1400.890 .923097 
1 860 . 217466E-02 1438.690 .928951 
1 880 . 945589E-03 1476.420 .920814 
1 900 .357652E-03 1514.190 .919130 
1 920 . 236392E-03 1551.930 .919473 
1 940 . 200728E-03 1589.670 .920706 
1 960 . 136390E-03 1627.430 .920990 
1 980 . 103828E-03 1665.260 .920645 
1 1000 . 1 14162E-03 1703.050 .920348 
1 1020 . 895274E-04 1740.920 .920323 
1 1040 . 653588E-04 1778.740 .920534 
1 1060 . 357031E-04 1816.500 .920714 
1 1080 . 233482E-04 1854.270 .920818 
1 1100 . 143805E-04 1892.000 .920894 
1 1120 . 114591E-04 1929.770 .920953 
1 1140 . 748877E-05 1967.490 .921009 
1 1160 .447210E-05 2005.290 .921050 
1 1180 . 294252E-05 2043.070 .921067 
1 1200 . 268724E-05 2080.810 .921073 
1 1220 . 237628E-05 2118.570 .921075 
1 1240 . 221764E-05 2156.390 .921079 
1 1260 . 223404E-05 2194.090 .921081 
1 1280 . 212072E-05 2231.850 .921084 
1 1300 . 196057E-05 2269.620 .921085 
1 1320 . 181849E-05 2307.380 .921087 
1 1340 . 173148E-05 2345.160 .921090 
1 1360 . 166904E-05 2382.920 .921090 
1 1380 . 160503E-05 2420.830 .921091 
1 1400 . 156905E-05 2458.690 .921090 
1 1420 . 172481E-05 2496.480 .921094 
1 1440 . 209843E-05 2534.230 .921095 
1 1460 . 314499E-05 2572.020 .921094 
1 1480 . 545472E-05 2609.800 .921094 
1 1500 . 625405E-05 2647.610 .921094 


. 382898E-01 -.837367E-02 -.547506E-03 
. 380419E-01 -.843978E-02 -.542679E-03 
. 380200E-01 -.849208E-02 -.543875E-03 
. 379861E-01 - . 833722E-02 -.544010E-03 
. 381321E-01 - . 830372E-02 -.549716E-03 
. 381633E-01 - . 829368E-02 --550581E-03 
•381185E-01 - . 829438E-02 -.551737E-03 
.382616E-01 -.827712E-02 -.556893E-03 
. 382532E-01 -.825276E-02 -.557438E-03 
•381129E-01 - . 823038E-02 -.555300E-03 
. 380537E-01 -.821366E-02 -.555913E-03 
. 382821E-01 - . 820079E-02 -.563803E-03 
. 384910E-01 - . 818702E-02 -.569678E-03 
. 384012E-01 - . 817254E-02 -.568314E-03 
. 382780E-01 -.815781E-02 -.566835E-03 
■382768E-01 -.814307E-02 -.568475E-03 
. 383443E-01 -.812840E-02 -.571179E-03 
. 383280E-01 -.811360E-02 -.571622E-03 
. 382910E-01 - . 809853E-02 -.571864E-03 
. 383039E-01 -.808342E-02 -. 57324 IE-03 
. 382835E-01 -.806835E-02 -.573524E-03 
•382661E-01 -.805342E-02 -.574031E-03 
. 382659E-01 -.803862E-02 -.574852E-03 
. 382639E-01 -.802396E-02 -.575542E-03 
. 382577E-01 -.800939E-02 -.576105E-03 
. 382552E-01 -.799499E-02 -.576733E-03 
. 382553E-01 -.798074E-02 -.577367E-03 
. 382558E-01 -.796656E-02 -.577962E-03 
. 382564E-01 -.795257E-02 -.578527E-03 
. 382567E-01 -.793868E-02 -.579043E-03 
. 382570E-01 -.792504E-02 -.579533E-03 
. 38257 IE-01 - . 791145E-02 -.579988E-03 
. 382566E-01 -.789797E-02 -. 58040 IE-03 
. 382557E-01 -.788466E-02 -.580773E-03 
. 382533E-01 -.787147E-02 -.581082E-03 
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A. 4. File grid. out 

The constituent elements of file grid. out are discussed in section 10.4. That section also 
shows the contents of this file from the initial run of this sample case. Its contents are shown 
here for the second run (screen 56): 




Block 

1, Surface 1 




(64 cells 

normal to body) 


i 

j 

dh_w 

Recell-W max 

. stretch 

1 

1 

. 132615E-05 

3.307665 

1.47 (18) 

2 

1 

. 134121E-05 

3.311790 

1.47 (18) 

3 

1 

. 136424E-05 

3.313079 

1.47 (18) 

4 

1 

. 139045E-05 

3.308474 

1.47 (18) 

5 

1 

. 142768E-05 

3.307920 

1.46 (18) 

6 

1 

. 146510E-05 

3.282688 

1.46 (18) 

7 

1 

. 151384E-05 

3.253656 

1.46 (18) 

8 

1 

. 1587 17E-05 

3.245656 

1.46 (18) 

9 

1 

. 165289E-05 

3.193581 

1.46 (18) 

10 

1 

. 172637E-05 

3.135483 

1.46 (18) 

11 

1 

. 182799E-05 

3.102324 

1.46 (17) 

12 

1 

. 198404E-05 

3.116151 

1.45 (18) 

13 

1 

. 211008E-05 

3.034105 

1.45 (18) 

14 

1 

. 234000E-05 

3.055790 

1.45 (18) 

15 

1 

. 248702E-05 

2.927279 

1.45 (18) 

16 

1 

. 278297E-05 

2.934100 

1.45 (17) 

17 

1 

. 309083E-05 

2.895659 

1.44 (18) 

18 

1 

. 337977E-05 

2.790136 

1.44 (17) 

19 

1 

.385189E-05 

2.781113 

1.44 (18) 

20 

1 

. 423707E-05 

2.657829 

1.43 (18) 

21 

1 

. 479993E-05 

2.596962 

1.43 (18) 

22 

1 

. 543809E-05 

2.517761 

1.43 (18) 

23 

1 

. 616728E-05 

2.427922 

1.42 (18) 

24 

1 

. 708869E-05 

2.356264 

1.42 (18) 

25 

1 

. 814689E-05 

2.268806 

1.41 (18) 

26 

1 

. 939657E-05 

2.180056 

1.41 (18) 

27 

1 

. 109298E-04 

2.098696 

1.40 (18) 

28 

1 

. 129232E-04 

2.023678 

1.40 (18) 

29 

1 

. 152506E-04 

1.912261 

1.39 (18) 

30 

1 

. 177 170E-04 

1.835846 

1.39 (18) 
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Appendix B 
Conic Geometry 


This appendix provides the definitions for the conic geometry inputs 


( new job ~ 1 ). 


Nomenclature 


b 

B 

( 

r* z. 0 

1 axi 

Rn 

n t 

fly: 

x. y. z 
0 


axial shape parameter 

cross-sectional shape parameter: ratio of principal radii of curvature 
axial eccentricity of nose 

cylindrical coordinates, in units specified via iunit 

radius for axisynimetric conic body 

body nose radius, in units specified via iunit 

radius of curvature in symmetry plane, in units specified via iunit 
i ad i us of curvature in side plane, in units specified via iunit 
( artesian coordinates, in units specified via iunit 
body half-angle (or conic geometry, deg 


Subscript: 

Junrt juncture between blunted forebody and cone afterbody 


For many configurations of interest, the body shape can be defined by a conic equation. 
Consider an axisynimetric conic body rotated about the z-axis, whose nose is at (z = 0.r = 0): 


The slope for this body 


r is 


r axi = r 2 = 2R N z 


Rr _ R s - bz 
dz 


0): 

b.i: 


7 (B.2) 

so that at the nose, the slope is infinite. 

The character of the conic nose is dictated by the axial shape parameter ( b ) which is related 
to its eccentricity (c). The relationship for b < 1 is 


= vun> 


while for b > 1 it is 




or 


or 


b = 1 - f 2 


b = 


I - f-2 
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Table B.l. Character of Axisynimetric Conic Geomet ry 


Shape 

b 

e 

Hyperbola 

< 0 

> i 

Parabola 

0 

i 

Ellipse 

> 0 

< i 

Circle 

] 

0 


These results are summarized in table B.l, which shows that b has a unique value for a parabola 
(where b = 0) and a sphere (b = 1). The value of b for a hyperbola is related to the half-angle 
(0) of its asymptote by the following equation: 

= — tan 2 0 ( ^ ^ ) 

An ellipse can be used to define the forebody of a blunted cone. The afterbody can be 
described by the simple equation 

7'axi = r = fjunct + ( S — -junct ) tan 0 (TCf) 

where ; juiirl and c juncl are the coordinates of the juncture between the ellipse and cone. 1 he 
slope of the cone is 

— = tan 0 ( B - 5 ) 

dz 

At the juncture between the ellipsoidal forebody and cone afterbody, both the position and 
slope of the body are continuous. The coordinates of this juncture can be determined by equating 
equations (B.2) and (B.5), substituting equation (B.l) for r, and solving for r. The resultant 
axial location of this juncture is 

Rn(. tan 0 \ _ /(> ' v ( i — ^ (B.(») 

* junr ' “ b V \/b + tan 2 0 / b ^ \/b cos 2 9 + am* 0 / 

The corresponding value for r "junct can be found from equation (B.l). 

r /unot = 2^ATSjuuct — ^-junct (B.l) 

NOTE: Substituting a value of 6=1 into equation (B.l) yields 

r'L = r* = 2 R N z - 

which is an equation for a circle. For axisynimetric flow, this gives a spherical 
forebody, with the sphere-cone juncture located at 

-junct = RN [1 — K ’ n ^ junct = Rj V < OS ^ 

NOTE: The above discussion can be applied to two-dimensional conics by simply 
replacing the variable r with y, the subscript axi with 2-1), and the word cone with 
“wedge." 
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figure B.l. Defining parameters for general conic geometry. 


I lie above discussion can be extended to three-dimensional geometries (fig. 15.1 
foil ow i n g exp ression : 

a 


do 


r 2 = 


B cos 2 <p -f si n ^6 


) with the 

(B.«) 


where li\ — H v - |_ 0 in equation (B.l). and 


(!) = 


< 


0 

tt/2 

7 T 


(upper symmetry plane) 
(side plane) 

(lower symmetry plane) 


The cross-sectional shape parameter is defined as 



3 — 0 


Values of B > 0 produce elliptical cross sections. The equation for an axisymmetric body is 
recovered by setting B = 1, which gives a circular cross section. 


NOTE: for b — B = T equation (B.8) gives a sphere of radius R\. 

The cylindrical coordinates (/%</>) can be converted to Cartesian coordinates (<i\y) using the 
following relations: 

x = r cos (p y = r sin <j> 
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Appendix C 

Installation Procedure 


I liis appendix covers l lie structure of INSTALL_LAURA .4. 1 and the structure of mAch+prOc. 


C.l. Structure of INSTALL_LAURA . 4 . 1 

I his script installs the LAURA code on this machine using the following procedures. Create 
a subdirectory for the LAURA source code (screen 57): 


VERSION=LAURA .4.1 

if [ -d $ VERSION ]; then # (if SVERSION exists already)... 

chmod 700 SVERSION 

chmod 700 SVERSION/* 2> /dev/null 

chmod 700 SVERSI0N/CUST0M/* 2> /dev/null 

rm -r SVERSION 
fi 

mkdir SVERSION 


Screen 57. 

Extract the source code from LAURA .4. 1 . tar . Z (screen 58): 


cd SVERSION 

zcat . ./LAURA. 4. 1 . tar .Z | tar xf - 


Screen 58. 

Compile and run the C program mAch+prOc to determine the machine architecture and number 
of available processors (screen 59): 





cc mach+proc . c -o mach+proc 
set ‘ mach+proc ‘ — 


# Determine architecture type 

# and number of processors. 


Screen 59. 

Compile the FORTRAN executables (ArrAy. flOwInlt. mAkEblk, sIzEIt, and stArt) as follows 
(screen 60): 


if [ ”$1 M = "0" ] ; then 

cf77 array. f -o ArrAy /dev/null 
cf77 flowinit.f -o flOwInlt /dev/null 
cf77 makeblk.f -o mAkEblk /dev/null 
cf77 sizeit.f -o sIzEIt /dev/null 
cf 77 start. f -o stArt /dev/null 
fi 

if [ M $1 M = M 1 H ]; then 

f77 array. f -o ArrAy 2> /dev/null 
f77 flowinit.f -o flOwInlt 2> /dev/null 
f 77 makeblk.f -o mAkEblk 2> /dev/null 
f77 sizeit.f -o sIzEIt 2> /dev/null 
f77 start. f -o stArt 2> /dev/null 
fi 

if [ "$l" = M 2" ]; then 

f77 array. f -o ArrAy 2> /dev/null 
f77 flowinit.f -o flOwInlt 2> /dev/null 
f 77 makeblk.f -o mAkEblk 2> /dev/null 
f77 sizeit.f -o sIzEIt 2> /dev/null 
f77 start. f -o stArt 2> /dev/null 
fi 

if [ M $1 M = M 3 M ]; then 

fc array. f -o ArrAy 2> /dev/null 
fc flowinit.f -o flOwInlt 2> /dev/null 
fc makeblk.f -o mAkEblk 2> /dev/null 
fc sizeit.f -o sIzEIt 2> /dev/null 
fc start. f -o stArt 2> /dev/null 
for FILE in * . F; do 

N0EXT= ‘ basename $FILE ,F‘ 
mv $FILE SNOEXT . FOR 

done 
f i 


Screen 60. 

NOTE: For CONVEX architectures, the suffixes of the subroutine files are changed 
from . F to .FOR. 

Tailor DEFAULTS to this machine (screen 61): 
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echo M $1 machine 0=CRAY , 1=SUN, 2=SGI, 

3=C0NVEX M > temp 

echo M $2 nprocmx number of processors a 

vailable" » temp 
cat DEFAULTS >> temp 
mv temp DEFAULTS 


Screen 61. 

Remove write privileges for all files to discourage user alteration of the LAURA files in 
$H0ME/L AURA. 4.1 (screen 62): 


chmod 500 * 

chmod 400 DEFAULTS TOP *.f mAch+prOc.c start* * . F* *.data * . inc 
cd . . 

chmod 500 $VERSI0N 


Screen 62. 


Add aliases for ARCHIVE, BL0X. CUSTOMIZE, INITIALIZE. KEEPER. LOCALIZE, PRELUDE, RESTORE, 
SIZEIT. and XCUSTOM to the user's .cshrc file (screen 63): 


if [ ! ”‘grep PRELUDE .cshrc I grep SVERSI0N . cshrc <M ]; then 

echo ">> Do you wish to add aliases to .cshrc (y/n) {n}? M 
read ANSWER 

if [ "SANSWER” = H y" -o M $ANSWER M = M Y M ] ; then 

for FILE in ARCHIVE BL0X CUSTOMIZE INITIALIZE KEEPER LOCALIZE PR 
ELUDE RESTORE SIZEIT XCUSTOM; do 

echo "alias SFILE ~/$VERSI0N/$FILE" » .cshrc 


Screen 63. 


NOTE: Type the command 


(source . cshrc j 


to activate the PRELUDE alias for this shell. 





C.2. Structure of mAch+prOc 

The C program mAch+prOc determines the architecture type, as well as available processors 
( nprormx), for the host machine. This program is compiled and executed by INSTALL_LAURA .4.1. 
The information is used by INSTALL_LAURA .4.1 to initialize the variables machine and nprocmx 
in DEFAULTS, which is later accessed by stArt. The operating system is also identified so that 
the various script files can be properly tailored to the host architecture. 

NOTE: On SGI systems, the existence of the R8000 CPU hardware is considered. If 
it exists, start .f is modified so that the appropriate flags are used in the compilation 
of laura via the Makefile. 

The source code for mAch+prOc. c is as follows (screen 04): 


#include <stdio.h> 

♦include <unistd.h> 

♦ifdef _C0NVEX_S0URCE 

# include <sys/sysinfo.h> 

#elif sun | I sgi 

# include <sys/utsname ,h> 

# include <string.h> 

# ifdef sgi 

# include <sys/sysmp.h> 

# include <invent.h> 

# endif 
#endif 

♦ifdef sgi 

istfpO 

{ 

# ifdef INV.IP21B0ARD 

inventory.t *entry; 

while ( (entry=get invent () ) l-NULL) { 

if (entry->inv_class==INV_PROCESSOR) 

if ( ent ry-> inv-t ype==INV_CPUB0 ARD ) 

if (entry->invjstate**INV_IP21B0 

endinvent () ; 
return(l) ; 

} 

} 

return(O) ; 

else 

return(O) ; 

endif 

} 

♦endif 


ARD) { 

♦ 

♦ 


Screen 64. 
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mainO 

{ 

int machine=0, processors^*), ostype=0, tfp=0; 

# if sun | | sgi 

struct utsname name; 
char *i; 

# elif -CONVEXJSOURCE 

struct system-information sysinfo; 

# endif 

# ifdef CRAY 

machine=0 ; 

# ifdef JSC_CRAY_NCPU 

processors=(int)sysconf (-SC.CRAYJICPU) ; 

# else 

processors=l ; 

# endif 

# endif 


# 

# 

# 

# 


ifdef sun 

machine^l ; 

ifdef _SC_NPRQCESSORS_CONF 

processors=(int)sysconf (JSCJIPROCESSORS-CONF) ; 

else 

processors=l ; 

endif 

uname (&name) ; 

if ( (i=strchr (name. release, 5 . >)) !“NULL) 

♦ i* *\0 * ; 

if (strcmp (name .release, "5 M )«*0) 
ostype=l ; 

endif 


Screen 64. Continued. 
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# ifdef sgi 

machine=2 ; 

processors=sysmp(MPJIPROCS) ; 
uname (&name) ; 

if ( (i=strchr(name .release , J J ) ) ! =NULL) 
*i=>\0>; 

if (strcmp(name .release , "6" ) ®*0) 
ostype=l ; 
if (istfp()==l) 
tf p-1 ; 

# endif 

# ifdef -CONVEX-SOURCE 

machine*3; 

getsysinf o (SYSINFQ JSIZE , fesysinfo) ; 
processors=sysinf o . cpu.count ; 

# endif 

printf ("machine , processors, ostype , tfp) ; 
exit (0) ; 

} 


Screen (i4. Concluded. 
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Appendix D 

Structure of PRELUDE 


In addition to serving as a front end for stArt, the script. PRELUDE provides file manage- 
ment capability in the working (LOCAL) directory. Specifically, the user is given the option to 
remove or keep LOCAL versions of files that are created by stArt. By default, PRELUDE uses the 
$HOME/LAURA .4.1 (baseline) version of stArt. However, if CUSTOM versions of any stArt source 
files exist, a CUSTOM version of stArt is used in lieu of the baseline version. Further, if LOCAL 
versions of any stArt source files exist, a LOCAL version of stArt is used in lieu of the baseline or 
CUSTOM version. After stArt is completed. PRELUDE creates subdirectory STRTf iles and places 
those include files created by stArt there ( .strt suffixes). If STRTf iles already exists, then 
the files it contains are updated based on this latest execution of stArt. 

The file conv.out contains the running residual history for a given case. If a new case is to 
be run in the same directory, the user may wish to remove the existing file so that the file begins 
with the new case (screen Go): 


VERS I 0N=LAURA .4.1 


if [ -f conv.out ]; then 

echo ’’File \ < conv.out’ already exists. M 
echo " Do you wish to remove it (y/n) {n}?" 
read ANSWER 


if [ 

else 

fi 


M $ANSWER" = "y " -o M $ANSWER M ■ "Y M ] ; then 
rm conv . out 

echo M File \‘ conv. out’ removed." 
echo " File \ 4 conv. out’ saved." 


fi 


Screen 65. 
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The user is also given the option to preserve or overwrite existing RESTART . in, TWALL.in, 
and data files each time PRELUDE is run (screen 6(5): 


# if files RESTART. in TWALL.in data already exist... 

for FILE in ‘Is RESTART. in TWALL.in data 2> /dev/null‘; do 

echo "File \‘$FILE’ already exists." 
echo " Do you wish to update it \c" 
echo "during this PRELUDE session (y/n) {n}?" 
read ANSWER 

if [ "$ANSWER" = "y" -o M $ ANSWER' 1 = "Y" ] ; then 
rm $FILE 

echo " File \‘$FILE* removed." 

else 

echo " File \‘$FILE’ saved." 
fi 

done 


Screen (56. 

Next, PRELUDE checks for the existence of LOCAL files with a .strt suffix. If any exist, the 
user is given the option to save or discard them before stArt is executed (streen Gi ). 


for FILE in ‘Is *.strt 2> /dev/null‘; do 
echo "LOCAL \‘$FILE’ exists." 

echo " Do you wish to preserve it (y/n) {n}?" 
read ANSWER 

if [ "SANSWER" = "y" -o "SANSWER" = "Y" ] ; then 
echo " LOCAL \‘$FILE"’ saved. 

else 

rm $FILE 

echo " LOCAL \‘$FILE M ’ removed, 
fi 

done 


Screen 67. 
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PRRmnp UDE expms ,h< ' " le DEF4ULTS i« tl'- LOCAL directory. If it, b present l„„ empty 

( "crtr! W)T ” IS ' S ' "*• W0 “ /U#,U -' , -‘ '™ion f «>pW to the LOCAL directory 



Screen 68. 
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If al iv LOCAL versions of stArt source files exist, a LOCAL stArt executable is created artel 
1 • r ft l, ax 4:HnMF /LAURA 4 1 version. This compilation requires the creation of symbolic 

s^finneiifier .home/l.™..:. , or «„« 

ale nit LOCAL. If a LOCAL executable already exists. PRELUDE checks to see if .t needs to be 
recompiled (screen 69): 



where 


compiU - 


CF (CRAY architectures) 
FC (all others) 


If LOCAL stArt source files are not present, tl.e possibility of CUSTOM files ,s considered. If 
they exist and the stArt executable is not up to date, it is recompiled, first, however 
links are created to any stArt source files (in IHOME/LAURA .4. 1), which are not in CUSTOM 


(screen 70): 
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SHOMER/ CUSTOM ; 

"‘Is -t st*rt* | awk ’{print $1}’ | head -1‘" = "stArt ]; then 


echo M < 


CUSTOM \‘ stArt’ executable is up>t<? date 


if [ -f stArt ] ; then 

echo " < Updating CUSTOM \' stArt’ executable > M ; 

else 

echo M < Creating CUSTOM \‘ stArt’ executable > n ; 
fi 

chmod 700 SHOMER; 
chmod 700 SHOMER/CUSTOM ; 

for FILE in 'cd SHOMER; Is -t start*'; do 
if [ ! -f SFILE ] ; then 

In -s SHOMER/SFILE . ; 
fi 

done ; 

$(. compile) start.f -o stArt; 

for FILE in ‘Is -t start*'; do 

if [ "‘Is -It SFILE I grep LAURA ,H ]; then 
rm SFILE; 
fi 

done 

chmod 500 SHOMER; 
chmod 500 SHOMER/CUSTOM; 


SHOMER/CUSTOM/stArt 


# link to CUSTOM stArt 


Screen 70. 

If no LOCAL or CUSTOM versions of stArt source files exist, create a symbolic link to the 
$H0ME/LAURA .4 . 1 stArt executable and use the following: 


In -s SHOMER/stArt . # ...use DEFAULT stArt. 
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Now stArt is executed, and it reads its required inputs either from the screen or from file 
INPUTS (screen 71): 


if 

i 

n $ 1 " ] ; then 




# 

Run start . . . 




stArt < $1 




# 

. . . reading from 

INPUTS. 

else 





# 





stArt 




# 

. . .reading from 

screen . 

fi 






# 



if 

i 

"‘Is -It stArt 1 

grep LAURA * 

" 1: 

then 

# 

Remove stArt if it’s 




rm stArt 




# 

just a sym-link 


fi 






# 

to default stArt. 


if 

c 

-f variabletw ] ; 

; then 








if [ r “wc -1 

variabletw 1 

awk 

’print $1 

> < i 

" = "0" ] ; then 




rm variabletw 



# 

rm variabletw if it is empty 



fi 







fi 










Screen 71. 

After stArt is executed, several subdirectories are created (if they do not already exist). Next, 
the old CHILDREN file is removed, and a new symbolic link is established (screen 72): 


mkdir OBJfiles OB Jf iles/LOCAL OBJf iles/CUSTOM STKTfiles 2> /dev/null 
rm -f OBJf iles/CHILDREN CHILDREN # remove old CHILDREN file i. sym-link 

touch OBJf iles/CHILDREN # create empty OBJf iles/CHILDREN file 

In -s OBJf iles/CHILDREN CHILDREN # create new CHILDREN sym-link 


Screen 72. 
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A reference copy of Makefile is 
(screen 73): 


created, and the INPUTS and DEFAULTS files 


are 


updated 



if [ ? “f .Makefile ]; then 


fi 


cp Makefile .Makefile 


# make a reference copy of Makefile 


mv INPUTS. active INPUTS 


# update INPUTS file for stArt 


# update DEFAULTS file (including VERSION number) for stArt 


echo " VERS I 0N=$ VERS ION" > TeMP 
tail +2 DEFAULTS . act ive >> TeMP 
mv TeMP DEFAULTS 
rm DEFAULTS . act ive 


Screen 73. 


Based on user specifications, up to three J ATTR4 ui , , 

pdqtadt • i . * xuee ^ input hies are created bv stArt- 

• TeMP suffiLTnofor. sUrt waTAw ut!>d ‘° l '" l|>orM - v *» 

- — “. ln . and ™u.in ? d X 

"* "™ — b -• >fH «. no, saved. the new fi ,e ^ 



Screen 74. 




Next, the files treated by stArt ( -T.MP suffixes) are moved to STRTfiles (with a .strt 
suffix). However, if the file already resides in STRTfiles. and ,1 is identical to the 
the LOCAL file is simply removed (screen <5): 


# for * . strt just created... 

for FILE in *.TeMP; do 

ST RT=‘ echo $FILE I asrk -F. ’{P rint $l}’‘-s trt 

if [ ! -f STRTf iles/$STRT 3; then # if file DNE in STRTfiles, 


else 


fi 


mv $FILE STRTf iles/$STRT 
chmod 400 STRTf iles/$STRT 


# move it there, 

# and make it read only 


diff $FILE STRTf iles/$STRT > /dev/null 2>ftl 

A # if files differ... 

if [$? -neO]; then * 

ec ho " Updated file \‘$STRT’ M 

mv -f $FILE STRTf iles/$STRT # move to STRTfiles 

chmod 400 STRTf iles/$STRT # make it read only 

# 

echo " No change in file \‘$STRT ,M 

rm SFILE # else *** AT ... 

# remove LOCAL file 


else 


fi 


Screen 75. 


Anv LOCAL files with a . strt suffix are compared with their new counterparts ( now in STRTfiles 
If they are identical, the LOCAL version is removed (screen 76): 
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if [ “‘Is *.strt 2> /dev/null‘" ]; then 
for FILE in *.strt; do 

diff $FILE STRTfiles > /dev/null 2>&1 

if [ $? -ne 0 ]; then # if new k old files are identical... 
rm -f $FILE 

echo "LOCAL \ 4 $FILE’ identical to STRTfiles version" 
echo " Therefore, LOCAL \‘$FILE’ removed." 


done 


Screen 7b. 

Ail estimate for the memory required, based on values from stArt, is calculated through 
execution of the LAURA utility SIZEIT (appendix M). If an external grid (nnrjob = 0) was 
specified in stArt, the user is given the option to initialize this grid now. litis initialization 
requires that the user input the name of the file that contains the grid (in PL0T3D format). The 
LAURA utility INITIALIZE (appendix I) is then executed for this file (screen 77): 


$HOME/$VERSION/SIZEIT 

if [ "‘grep new job DEFAULTS i awk * {print = "0" ]; then 

if [ ! -f RESTART. in]; then # if RESTART . in DNE .. . 

echo "Do you wish to initialize grid file now (y/n) {n}?" 
read ANSWER 

if [ "SANSWER" = "y" -o "$ANSVER M = M Y" ] ; then 
echo "Enter name of grid file; M 
read GRIDIN 

$H0ME/$ VERSION/ INITIALIZE SGRIDIN 
fi 


Screen 77. 
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Appendix E 

Makefile and Its Supporting Files 


When PRELUDE is run. stArt creates a sophisticated Makefile for LAURA based on the 
user inputs and the machine architecture. When the resultant Makefile is activated, it in turn 
executes a number of script files. The structure of the Makefile and its supporting cast are 
discussed in the subsections of this appendix. 

E.l. Structure of Makefile 

liie Makefile contains a preamble that is common to all cases and architectures (screen 7S): 


PROG= laura 

SHELL= /bin/sh 

SOURCE= $ (HOME) /LAURA. 4.1 
OB JDIR= OBJfiles 
STRTDR= STRTfiles 
DBGDIR= BUGOUT 
F0RDIR= FORTRAN 


Screen 78. 


The source files are supplied through the SRCS list. The contents of this list are case dependent 
as shown below (screen 79): 
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SRCS= aaa.F abseig.F abseigl.F algnshk.F asave.F atime.F \ 

blkout.F bmat.F bndr.F bndrfmn.F bndrmn.F bound. F \ 


blturb.F csturb.F parab.F prabola.F stretch. F \ 
boundf.F boundr.F boundu.F boundv.F consrv.F defbod.F \ 
def mom . F dirswp.F double. F dropone . F drv.F efg.F \ 

(turbulence) 

etherm.F prand.F tannehill.F vinokur. F vintabl.F visc.F \ 

(equilibrium) 

gatdfl.F gatdf2.F gatdf3.F gatgeof .F nsbnd.F \ (full N 

gatface.F gatfgmn.F gatfmn.F gatgeo.F gatgeoa.F gatgmn.F \ 
gatmn.F gatscat.F gatscta.F gauss. F invflx.F limiter. F \ 

avier- Stokes) 

inv2d. F \ 

( ndim 3) 

kinetic. F source. F air.F \ (nonequilibrium) 

metric.F minmod.F moment . F outputa.F plotprep.F prpavg.F \ 
prpaxj.F q4iuniv.F reload. F rmat . F saveblk.F \ 

sample_handler . F \ 

setup. F swptask.F taskit.F thermo. F trnsprt.F viscflx.F \ 

(SUN) 

sthrlnd.F \ 
vrapup . F 

0BJS= $ (SRCS : .F=.o) 

(perfect ga.s) 


Screen 79. 

NOTE: The LAURA algorithm uses compile directives to activate and deactivate 
coding based on user specifications for a given application. These directives are 
used by the host machine's preprocessor. On most architectures, the preprocessor 
is applied automatically to any file with a .F suffix during its FORTRAN compilation. 

For CONVEX architectures, however, the preprocessor is applied automatically to 
any file with a .FOR suffix. This anomaly is handled during the installation process 
(chapter 5) and by stArt. However, notice the .FOR suffixes if the Makefile is edited 
on CONVEX architectures. 

The compilation flags (which are architecture dependent) are supplied next. For CRAY 
machines, they are as follows (screen 80): 


NPR0C= np rocs 


#PROFLIB«lprof 

# Profile library 

#FFLAGS*-Wf M -a stack -ez M 

# profile 

#FFLAGS=-Wf M -a stack -ez" -F 

# flowtrace 

FFLAGS= -Wf"-a stack -o aggress" 

# optimize 

DFLAGS= ~Wf M -a stack -g M 

# debug 


Screen 80. 


For SUN machines, the flags are as follows (screen 81): 





#FFLAGS=-C ~p 

# check bounds & profile 

FFLAGS= -03 

# optimize 

DFLAGS= -C -g 

# check bounds & debug 


Screen 81. 

For SGI machines, they are as follow 

s (screen 82): 

#FFLAGS=-checkJ)ounds -p 

# check bounds & profile 

FFLAGS= -02 

# optimize 

DFLAGS= -check-bounds -g 

# check bounds & debug 


Screen 82. 

For GO NY EX machines, they are as 

follows (screen 83): 

#FFLAGS=-cs -p 

# check bounds fc profile 

FFLAGS= -03 

# optimize 

DFLAGS= -cs -g 

# check bounds & debug 


Screen 83. 

The epilogue to the Makefile is 


include CHILDREN 


which provides the Makefile with a list of included files ( . inc and . strt suffixes) that each 
source file ( . F. .FOR, or . f suffix) is dependent upon. This allows make to recognize whether a 
file (or any include file it depends upon) has been modified since the last. make. If not, the file 
is not recompiled, thus saving compilation t ime and costs. 


E.1.1. Command: make 


The command 

(make) 

executes the following ik defa.ult" procedure (screen 84 ) : 
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default : 

Cecho " M ; \ 

Cecho n <Estimating memory requirements for executable > M ; \ 

Cecho mt ; \ 

C$ (SOURCE) /SIZEIT 

Cecho M " ; \ 

Cecho "<Building symbolic links in $(OBJDXR) >"; \ 

Cecho ,,M ; \ 

C$ (SOURCE) /SYMLINKS $(SOURCE) $(0BJDIR) $(STRTDR) $(PROG) $(DBGDIR) 

Cif [ ”$(F0RTDR) M » M $ (FORDIR) M ]; then \ 
echo l,M ; \ 

echo "< Preprocessing .F files >"; \ 

echo MM ; \ 

( cd $ (FORDIR) ; \ 

for FILE in $(SRCS) ; do \ 


Screen 84. 

The structure of the script SIZEIT is given in appendix M. The structure of the script SYMLINKS 
is given in appendix E. section E.2. The preprocessing sequence is machine dependent. For 
CR AY and SGI machines, it is as follows: 


$ (compile) -P . ./$(OBJDIR)/$$FILE; \ 

mv ‘basename $$FILE . F‘.i ‘basename $$FILE .F^f; \ 


where 


compile = 


CF (CRAY architectures) 
FC (all others) 


For SUN machines, it is as follows: 


$(FC) -F . ./$(OBJDIR)/$$FILE; \ 


For CONVEX machines, it is as follows: 


NOEXT* 1 basename . . /$(0B JDIR)/$$FILE .F0R‘; \ 
epp . ./S(OBJDIR)/$$FILE > $$N0EXT.f; \ 


The remainder of the default procedure is shown below (screen 85): 
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else \ 


done ) ; \ 

$(SDURCE) /CHECKERS $(OBJDIR) $(DBGDIR) • \ 
echo ,tM ; \ x 

echo "< Building object files and executable >" • \ 
echo ,,M ; \ 1 ' 

( cd S(OBJDIR) ; \ 

make FFLAGS=’$(FFLAGS) ’ $(PROG) ); \ 


«if [ ! "$(OBJDIR) M = ”$(DBGDIR)" ] ; then \ 
echo MM ; \ 

echo ”< Removing symbolic links in SCtJBJDIR) >■■ . \ 
echo M ”; \ ’ ' 

( cd $(OBJDIR) ; \ 

rm -f Hake, start* *.F* *.f *.inc *.strt ..trace- \ 
exit 0 ) ; \ * ' 

fi 


$(PR0G) : $(0BJS) 

$( compile) $ (FFLAGS) -o $® $(OBJS) 


screen 


where 

make = / P ma ^ e ~ Jiiprocs, (SGI arch i lectures) 
| make, (all others) 
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E.1.3. Command: make fortran 


The command 


make fortran J 


executes 


the following procedure (which, in turn, executes 


s the default make procedure ( screen XT ) ): 



Screen XT. 
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E.1.4. Command: make clean 


The command 

(make clean j 

removes all existing object files ( .o suffix) from the OBJfiles subdirectory. The procedure is as 
follows (screen XX): 


clean: 

8if [ "‘cd $(0BJDIR) ; Is *.o 2> /dev/null‘" ]; then \ 
echo \ 

>"; \ 

echo M < Removing object files from $(GBJDIR) 
echo mi ; \ 
rm $(0BJDIR)/*.o; \ 

else \ 

echo \ 

echo M < ERROR: No object files exist in $(0BJDIR) 

echo ,MI ; \ 

>"'• \ 

fi 





E.2. Structure of SYMLINKS 


I lie script SYMLINKS is executed by the Makefile during its compilation of the LAURA 
code. This script establishes symbolic links to the source files necessary for this compilation. 
As a result, the Makefile knows when to use a LOCAL or CUSTOM version of a file in lieu of the 
installed ($HOME/LAURA . 4 . 1) version. The first step in this linking process is to remove any links 
that might remain from a previously aborted compilation (screen X9): 


VERSION=LAURA. 4 . 1 

SOURCE=$ 1 

0BJECT=$2 

START=$3 

PR0G=$4 

DEBUG=$5 

cd $OBJECT 

rm -f Make^ ♦.data ♦ . F* ♦.f ♦.inc ♦.strt 2> /dev/null 


Screen N9. 

Next, the default links are reestablished (screen 90): 


In -s . . /SSTART/* . 2> /dev/null 

In ~s . ./Makefile . 2> /dev/null 


In -s $SOURCE/Makedep+ 
In -s $S0URCEA.F+ 

In -s SSOURCE/^ . inc 
In -s SSOURCE/ ♦ .data 


2> /dev/null 
2> /dev/null 
2> /dev/null 
2> /dev/null 


if [ M $0BJECT" ! = "$DEBUG" ]; then 
rm -f ../$PR0G 2> /dev/null 
In -s $0B JECT/$PR0G ../$PR0G 
fi 


rm ~f starts CUSTOM/^.rm L0CAL/+.rm 2> /dev/null 


Screen 90. 




If any CUSTOM files exist, they are used instead of t he $HOME/LAURA 4 1 versions To 
l>l. S l. I lls. I „ WOHE/LAURA.4.1 nvn.Mk- link 1 , will, a link ,o , l.e CUSTOH ni. « ' 

'rr r ™ ni,,i ' a,i "" *■ - •»-*- 

' °' CUST0M < r FOR, and .f suHIms) in checked (scree,, 91 


rm CUSTOM/*. rm 2> /dev/null 


for FILE in 'cd CUSTOM; Is *.F* *.f 2> /dev/null* • do 

echo "CUSTOM \‘$FILE’ used in last compilation " 
N0EXT=‘echo $FILE I avk -F. > {print $1}>< 
if [ ! -f $SOURCE/CUSTOM/$FILE ] ; then 

echo "but CUSTOM \‘$FILE> does not exist " 
if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
rm CUSTOM/SFILE 
fi 


else 

ompilat ion. " 


fi 


echo " CUSTOM \‘$FILE' still exists, and will be used in this c 

if C ! "‘grep SVERSION $SOURCE/CUSTOM/$FILE‘" ]; then 

echo WARNING: VERSION mismatch. Still use (y/n) {n} 

read ANSWER 

if [ "SANSWER" = "y" -o "SANSWER” = "Y" ] ; then 
rm $N0EXT. F* 

In -s $SOURCE/CUSTOM/$FILE . 

else 

rm SNOEXT.o 2> /dev/null 
touch CUSTOM/SFILE. rm 
fi 


else 


fi 


rm SNOEXT.F* 

In -s $S0URCE/ CUSTOM/SFILE . 


done 


Screen 91. 
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for INC in ‘cd CUSTOM; Is *.inc 2> /dev/null‘; do 

echo "CUSTOM \‘$INC’ used in last compilation..." 
if [ ! -f $SOURCE/CUSTOM/ $ INC ] ; then 

echo "but CUSTOM \‘SINC’ does not exist." 
rm CUSTOM/SINC 

for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 

for FILE in ‘cd SDIR; grep -1 $INC *.F* *.f 2> /dev/nul 


do 


NOEXT= ‘ echo $FILE I auk -F. ’{print $l}’‘ 
if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 


done 


echo " CUSTOM \‘$INC’ still exists, and mill be used in this co 

if [ ! "‘grep SVERSION $SOURCE/CUSTOM/$INC‘ " ]; then 

echo "WARNING: VERSION mismatch. Still use (y/n) {n[? 

read ANSWER 

if [ "SANSWER" = "y” -° "SANSWER" = "Y" ] ; then 

rm SINC 

In -s SSOURCE/ CUSTOM/SINC . 


else 


fi 


else 


*.f 2> /dev/null ( ; do 
int $1} 1 * 


touch CUSTOM/SINC.rm 

for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 

for FILE in ‘cd SDIR; grep -1 SINC *.F* 

NOEXT=‘echo SFILE I a»k -F . ’{pr 

if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 


done 


done 


f i 


rm SINC 

In -s SSOURCE/ CUSTOM/SINC . 


fi 


done 




New CUSTOM files may have been created since the last compilation. Therefore, the next step 
is to locate any CUSTOM files that were not used in the previous compilation and replace the 
$HOME/LAURA .4.1 link with a link to the CUSTOM file (screen 93): 


for FILE in cd SSDURCE/CUSTQM; Is *.F* *.f 2> /dev/null | grep -v start 4 ; do 
if [ " 4 cd CUSTOM; Is $FILE 2> /dev/null * M ]; then 

if [ M< cd CUSTOM; Is SFILE.rm 2> /dev/null <M ]; then 
rm CUST0M/$FILE* 
fi 

else 

echo ''CUSTOM \ 4 $FILE’ exists, and will be used in this compilati 

on." 

if [ ! "‘cd LOCAL; Is $FILE 2> /dev/null 4 " ]; then 
N0EXT= 4 echo $FILE | awk -F. ’{print $1}’‘ 
if [ ! "‘grep $VERSI0N $SOURCE/CUSTOM/$FILE‘ " ]; then 

echo " WARNING: VERSION mismatch. Still use ( 

y/n) {n}?" 

read ANSWER 

if [ "SANSWER" = "y" -o "SANSWER" = "Y" ] ; the 
n 

rm SNOEXT.* CUST0M/$N0EXT.* 2> /dev/null 
In -s $S0URCE/CUST0M/$FILE . 
touch CUSTOM/$FILE 
fi 

else 

rm $NDEXT . * CUSTOM/$NOEXT.* 2> /dev/null 
In -s $SOURCE/CUSTOM/$FILE . 
touch CUSTOM/$FILE 


Screen 93. 



for INC in ‘cd $SOURCE/CUSTOM; Is *.inc 2> /dev/null I grep -v start'; do 
if [ "‘cd CUSTOM; Is $INC 2> /dev/null‘" ]; then 

if [ "‘cd CUSTOM; Is SINC.rm 2> /dev/null ]; then 
rm CUSTOM/SINC* 
fi 


else 


y/n) {n}?' 


echo "CUSTOM V$INC’ exists, and will be used in this compilatio 

if [ » "‘cd LOCAL; Is SINC 2> /dev/null <M ]; then 

if [ ! " ‘ grep SVERSION SSOURCE/ CUSTOM/SINC ‘ " ]; then 

echo " WARNING: VERSION mismatch. Still use ( 

read ANSWER 

if [ "$ANSWER" = "y" -o "$ANSWER M = M Y" ] ; the 
rm $INC 

In -s SSOURCE/CUSTOM/SINC . 
touch CUSTOM/SINC 


else 


NC *.F* *.f 2> /dev/null c ; do 
-F . J {print $1 } ’ * 


for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 
for FILE in ‘cd $DIR; grep -1 $1 

N0EXT*‘ echo SFILE I awk 

if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 


done 


done 


fi 


else 


fi 


rm $INC 

In -s SSOURCE/ CUSTOM/SINC . 
touch CUSTOM/SINC 


fi 


fi 


done 


Screen 93. Concluded. 
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An analogous procedure is employed for LOCAL files. If a LOCAL file exists, it is used in place 
of the $H0ME/LAURA.4. 1 or CUSTOM versions through the creation of a link to the LOCAL file. The 
status of LOCAL subroutine files ( . F, .FOR, and . f suffixes) is checked (screen 94): 


rm LOCAL/*. rm 2> /dev/null 

for FILE in ‘ cd LOCAL; Is * . F* *.f 2> /dev/null do 

echo "LOCAL \‘$FILE* used in last compilation. .. M 
N0EXT=‘ echo $FILE | awk -F. ’{print $l}>‘ 
if [ ! -f . ,/SFILE ] ; then 

echo " but LOCAL ^SFILE’ does not exist.” 
if [ -f SNOEXT.o ] ; then 

if [ -f SSOURCE/ CUSTOM/ $FILE ] ; then 
touch CUSTOM/SFILE 
fi 

rm SNOEXT.o 
rm LOCAL/SFILE 
fi 

else 

echo " LOCAL \ < $FILE’ still exists, and will be used in this co 

mpilation. " 

if [ ! M 4 grep SVERSION ../$FILE tH ]; then 

echo M WARNING: VERSION mismatch. Still use ( 

y/n) {n}?" 

read ANSWER 

if [ "$ANSW£R M ■ M y" -o "SANSWER" = M Y M ] ; then 
rm $N0EXT.F* CUSTOM/SNOEXT. * 2> /dev/null 
In -s . ,/SFILE . 

else 

if [ -f SSOURCE/ CUSTOM/SFILE ] ; then 
touch CUSTQM/$FILE 
fi 

rm SNOEXT.o 2> /dev/null 
touch LOCAL/SFILE . rm 
f i 

else 

rm SNOEXT.F* CUSTOM/SNOEXT.* 2> /dev/null 
In -s . ./SFILE . 
fi 
fi 

done 


Screen 94. 


Next , the status of LOCAL include files ( . inc and .strt suffixes) is reviewed (screen 95): 
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for INC in ‘cd LOCAL; Is *.inc *.strt 2> /dev/null‘ ; do 
echo "LOCAL \‘SINC’ used in last compilation..." 
if [ ! -f . ,/$INC ] ; then 

echo "but LOCAL \‘$INC’ does not exist." 
if [ -f $SOURCE/ CUSTOM/ $INC ] ; then 
touch CUSTOM/SINC 
fi 

rm L0CAL/$INC 

for DIR in $SOURCE SSOURCE/CUSTOM . . ; do 
if [ -d $DIR ] ; then 

for FILE in ‘cd $DIR; grep -1 $INC *.F* *.f 2> / 


dev/null ‘ ; do 


NOEXT=‘ echo SFILE I avk -F. ’{print $1}’ 

if [ -f SNOEXT.o ] ; then 
rm $N0EXT.o 
fi 


pilation . " 


echo " LOCAL \‘$INC’ still exists, and Bill be used in this com 

if [ ! "‘grep SVERSION . ./$INC‘“ ]; then 

echo "WARNING: VERSION mismatch. Still use (y/n) {n}?" 

read ANSWER 

if [ "SANSWER" = "y" -o "$ANSWER" = "Y" ] ; then 
rm $INC CUSTOM/SINC 2> /dev/null 
In -s . ,/SINC . 


NC * . F* *.f 2> /dev/null' ; do 
-F. ’ {print $1} ’ ‘ 


if [ -f SSOURCE/ CUSTOM/SFILE ] ; then 
touch CUSTOM/SFILE 
fi 

touch LOCAL/SINC.rm 

for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 
if [ -d SDIR ] ; then 

for FILE in ‘cd SDIR; grep -1 SI 

NOEXT= ‘ echo SFILE I ask 

if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 


rm SINC CUSTOM/SINC 2> /dev/null 
In -s . ,/SINC . 
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Filially, any LOCAL files that were not used in the previous compilation are located, and the 
existing link is replaced with a link to the LOCAL file (screen 90): 


for FILE in 4 cd Is *.F* *.f 2> /dev/null | grep -v start 4 ; do 
if [ " ‘ cd LOCAL; Is $FILE 2> /dev/null 4 " ]; then 

if [ M< cd LOCAL; Is SFILE.rm 2> /dev/null 4 M ]; then 
rm LOCAL/SFILE* 
fi 

else 

echo ’’LOCAL \ 4 $FILE’ exists, and will be used in this compilatio 

n." 

N0EXT= 4 echo $FILE | awk -F. ’{print $l}’ 4 
if [ ! " 1 grep SVERSION . . /SFILE 4 " ]; then 

echo "WARNING: VERSION mismatch. Still use (y/n) {n}?" 

read ANSWER 

if [ "SANSWER" = "y" -o "SANSWER" = "Y" ]; then 
rm SNOEXT.* CUSTOM/SNOEXT . * 2> /dev/null 
In -s . ,/SFILE . 
touch LOCAL/SFILE 

else 

if [ -f $SOURCE/CUSTOM/$FILE ] ; then 
touch CUST0M/$FILE 
fi 


rm SNOEXT.* CUSTOM/SNOEXT . * 2> /dev/null 
In -s . ,/SFILE . 
touch LOCAL/SFILE 






for INC in ‘cd . . ; Is *.inc *strt 2> /dev/null I grep -v start*; do 
if [ " ‘ cd LOCAL; Is $INC 2> /dev/null *" ]; then 

if [ " ‘ cd LOCAL; Is SlNC.rm 2> /dev/null*" ]; then 
rm LOCAL/SINC* 


echo "LOCAL \‘$INC’ exists, and will be used in this compilation 

NOEXT=‘echo SINC I auk -F. * {print Si}’* 
if [ ! "‘grep $VERSI0N ../SINC*" ]; then 

echo "WARNING: VERSION mismatch. Still use (y/n) {n}?" 

read ANSWER 

if [ "$ANSWER" = "y" -o "SANSWER" = "Y" ] ; then 
rm $INC CUSTOM/SINC 2> /dev/null 
In -s . . /$INC . 
touch LOCAL/SINC 

for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 
if [ -d $DIR ] ; then 

for FILE in ‘cd $DIR; grep -1 SI 


NC * . F* *.f 2> /dev/null*; do 


-F. ’{print $1}’ 


N0EXT= * echo $FILE I auk 

if t -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 


if [ -f SSOURCE/ CUSTOM/SINC ] ; then 
touch CUSTOM/SINC 
fi 


*.f 2> /dev/null* ; do 


int $1} ’ * 


rm SINC CUSTOM/SINC 2> /dev/null 
In -s . ./SINC . 
touch LOCAL/SINC 

for DIR in SSOURCE SSOURCE/CUSTOM . . ; do 
if [ -d SDIR ] ; then 

for FILE in ‘cd SDIR; grep -1 SINC *.F* 

N0EXT= * echo SFILE I ank -F. ’{pr 

if [ -f SNOEXT.o ] ; then 
rm SNOEXT.o 
fi 
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The final task performed by SYMLINKS is to create the file ECHOSTRT. This file is a concatena- 
tion of those include files (with a .strt suffix) which contain FORTRAN parameter statements. 
As discussed in section 9.2, these files provide user control of LAURA during compilation. At 
laura run-time, this file is printed to standard output. 

NOTE: The file ECHOSTRT should not be mistakenly edited in an attempt, to effect 
changes to the laura executable. Modifications should be made via PRELUDE, or 
t hrough a LOCAL version of the appropriate source files, followed by a recompilation 
of laura (screen 97): 


rm -f ECHOSTRT 2> /dev/null 
cat $H0ME/$VERS I ON/TOP > ECHOSTRT 

echo " File \‘ ECHOSTRT’ was created by \‘make’ on 'date'. 11 » ECHOSTRT 

for FILE in HEADER, strt algnshk_vars . strt gas_model_vars . strt \ 
issd.assn . strt iupwind_assn . strt mtaska_assn. strt \ 
nordbc_assn. strt parameter . strt source.vars . strt \ 
sthrlnd_vars . strt ; do 

if [ -f $FILE ] ; then 

echo "Contents of LOCAL file V$FILE’: M » ECHOSTRT 
LINES= ‘ wc -1 $FILE | awk ’{print $1} M 
LINES=‘expr SLINES - 8< 
tail +6 SFILE I head -$LINES » ECHOSTRT 

else 

if [ "‘cd $START ; wc -1 SFILE I awk ’{print $l}’ 1 " = "8" ]; then 
echo "File \‘$FILE’ is not active." » ECHOSTRT 

else 

echo "Contents of file \‘$FILE’: M » ECHOSTRT 
LINES=‘wc -1 $START/$FILE I awk 5 {print Si}’ 4 
LINES= ‘ expr SLINES - 8 4 

tail +6 SSTART/SFILE I head -SLINES » ECHOSTRT 
fi 
fi 

done 


Screen 97. 


NOTE: As mentioned in section 10.1, the contents of file data (as well as files 

assign_tasks, transition, and variabletw, if they exist at run-time), are also 
echoed to standard output. However, since these files provide user control during 
execution rather than compilation, their contents are not included in file ECHOSTRT. 
Rather, as their contents are read in by LAURA, they are also echoed to the screen 
so that the values that are actually used in the current run are reflected. 

The logic here checks for the presence of LOCAL versions of these files. If any are present, they 
are concatenated in lieu of the originals produced by stArt (which are located in STRTf iles, 
a subdirectory of the LOCAL directory). A complete list of LOCAL and CUSTOM files used in this 
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compilation is also included in ECHOSTRT. Thus, ECHOSTRT is a record of t he user-defined tailoring 
that was used in the most recent compilation of LAURA (screen 9X): 


if t -d $0BJECT/L0CAL ] ; then 

if [ "‘Is -t $0BJECT/L0CAL‘ " ]; then # if dir is not empty... 

echo "The following LOCAL files were used in the last \‘make’: M 

» ECHOSTRT 

for FILE in <cd SOBJECT/LOCAL; Is * 2> /dev/null'; do 

echo " $FILE" » ECHOSTRT 

done 

f i # 

fi 

if [ -d SOBJECT/CUSTOM ] ; then 

if [ " ‘Is -t SOBJECT/CUSTOM* M ]; then # if dir is not empty... 

echo "The following CUSTOM files were used in the last \ < make , : n 

» ECHOSTRT 

for FILE in *cd SOBJECT/CUSTOM; Is * 2> /dev/null 4 ; do 
if [ ! -f $OBJECT/LOCAL/$FILE ] ; then 
echo " SFILE" >> ECHOSTRT 
fi 

done 

fi # 

fi 

chmod 400 ECHOSTRT 


Screen 98. 
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E.3. Structure of CHECKERS 

have b^f c 'd ^si n ce' rj'rlart 1 make ho' o ^ Tfil ^ If th <* compilation 'flags 

- * “ '* - 



Screen 99. 
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E.4. Structure of Makedep 


This script determines 
the front end for the k *awk 


the include dependencies of each LA Ul{ A source file, 
(a UNIX utility) file Makedep. awk (screen 100): 


Makedep is 


for file in *.f *.F *.F0R; do 

awk -f Makedep. awk $file 2> /dev/null 

done 


Screen 100. 

Makedep. awk establishes the file interdependencies by locating all include statements in 
each of the subroutine files ( .f, -F. and .FOR suffixes). (See screen 101.) 
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These dependencies are output in a formal that is usable in the Makefile (scieen 102). 


END 

{ 

# Extract the input filename. 


split(FILENAME,inp,".") ; 


line=inp[l] M .o: \t M ; 

# Add .o extension and tab to name. 


if (n-=0 ) 

# If no includes were found in 


{ 

print line; 
exit ; 

} 

j=l ; 

# this file, then just print 


# the filename and exit. 


while (j<=n) 
{ 

i=l ; 

# Loop though each included filename. 


while (i<=3) 

{ 

line=line 

j ++ ; 

# Only put 3 filenames on one line. 


fn[j] M " ; # Concatenate the names. 


if (j-l==: 

n) break; # Determine if 


if (i==3) 

line=line "\\ M ; # continuation 


i++; 

# characters 


} 

# are required. 


print line; 
line= M \t \t" ; 

i 

} 

# Output the line. 


Screen 102. 


Makedep is executed each time the Makefile is executed, and its output is directed to the 
file CHILDREN. The file CHILDREN is accessed by the Makefile to determine which include files 
( .inc and .strt suffixes) each source file ( .F. .FOR. or .f suffix) is dependent upon. If any of 
these files have been modified more recently than the object file (.o suffix) was created, then 
the object file is recompiled. In other words, with each execution of make, only those object files 
that are outdated are recompiled. 
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Appendix F 

Structure of ARCHIVE 


The script ARCHIVE provides the user with an archival capability for the given working 
directory. I n other words, a. user can use this command to save key files for future use. These 
files can be restored at some future date using the RESTORE command (appendix L). After the 
restoration process, the solution can be picked up where it left off. 

The command ARCHIVE is executed from the present working (LOCAL) directory. The proce- 
dure is as follows. First, a temporary subdirectory named ARCHIVE is created: 


H0MER=$H0ME/$ VERS I ON 
mkdir ARCHIVE 2> /dev/null 


Within this directory, several subdirectories are created to hold various classes of files. First, 
the DEFAULTS and INPUTS files are saved in case the user would like to repeat PRELUDE in the 
future (screen 103): 


if [ M ‘ls DEFAULTS INPUTS 2> /dev/null ‘ " ]; then 

mkdir ARCHIVE/IN 2> /dev/null 

for FILE in DEFAULTS INPUTS; do 

if [ -f SFILE ] ; then 

cp SFILE ARCHIVE/IN 
fi 

done 

fi 


Screen 103. 





Next , the input files for laura (RESTART, in, assign_tasks, transition. TWALL . in, and variabletw) 
are saved to provide a smooth restart capability (screen 104): 


mkdir ARCHIVE/CONTROL 2> /dev/null 

for FILE in RESTART, in assign_tasks data transition TWALL. in variabletw; do 
if [ -f $FILE ] ; then 

cp SFILE ARCHIVE/CONTROL 
fi 

done 

if [ ! Mt ls -t ARCHIVE/CONTROL* M ]; then 
rmdir ARCHIVE/CONTROL 
fi 


Screen 104. 

If the master input files (RESTART .MASTER and TWALL . MASTER) exist, they are also saved, along 
with the file conv.out. which contains the convergence history for the run (screen 105): 


if [ "‘Is RESTART. MASTER TWALL. MASTER 2> /dev/null 0 ’ ]; then 

mkdir ARCHIVE/MASTER 2> /dev/null 

for FILE in REST ART. MAS TER TWALL. MASTER; do 
if [ -f SFILE ] ; then 

cp SFILE ARCHIVE/MASTER 
fi 

done 


if [ -f conv.out ]; then 

mkdir ARCHIVE/CONV 2> /dev/null 
cp conv.out ARCHIVE/CONV 


Screen 105. 
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Copies of any CUSTOM files that might exist are saved as follows (screen 100): 


if [ "‘Is OBJfiles/CUSTOM 1 " ]; then 

mkdir ARCHIVE/CUSTOM 2> /dev/null 
for FILE in ‘Is OBJfiles/CUSTOM 2> /dev/null* ; do 
cp $H0MER/CUST0M/$FILE ARCHIVE/CUSTOM 

done 

fi 


Screen 106. 

Any LOCAL files are also saved (screen 107): 


if [ M ‘ls OB Jf iles/LOCAL 4 M ]; then 

mkdir ARCHIVE/LOCAL 2> /dev/null 
for FILE in ‘Is OBJf iles/LOCAL 2> /dev/null‘; do 
cp SFILE ARCHIVE/LOCAL 


done 




Now the contents of the subdirectory ARCHIVE are ready to he packaged in a tarf ile. First . 
the user is prompted for the desired name for this file. Next the tarf ile is created. As a final 
step, the subdirectory ARCHIVE and its contents are removed (screen JOS): 


echo " Enter name for ARCHIVE file: " 

read TARFILE 

if [ -f $TARFILE ] ; then 

echo " File \‘$TARFILE’ already exists. Overwrite it (y/n) {n}? " 

read ANSWER 

if [ "$ANSWER" = "y" -o "SANSWER" = "Y" ] ; then 
rm -f $TARFILE 

else 

echo M ARCHIVE procedure aborted" 
exit 0 


cd ARCHIVE 

tar cf . . /STARFILE * 
chmod 400 . ./STARFILE 

cd . . 

rm -r ARCHIVE 


Screen 108. 
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Appendix G 


Structure of BLOX 


I lie script BLOX allows a user to assemble several computational blocks into a single-block, 
master copy of the solution. This utility also allows the user to partition a master copy of the 
solution into several blocks to reduce memory overhead associated with multitasking. Smaller 
working blocks can also be created from the master to concentrate relaxation cycles in critical 
regions or to implement a block marching strategy (from nose to tail and/or from windside to 
leeside) over vehicles. As solutions in the smaller working blocks are converged, they can be 
resaved in the master copy using the BLOX utility. 

BLOX operates on the working copy restart file, RESTART. in, and, if necessary, on the asso- 
ciated wall temperature file. TWALL.in. The respective master files are called RESTART . MASTER 
and TWALL . MASTER. To use this utility, the user types 



which serves as a front-end to the mAkEblk FORTRAN executable. The user is prompted for 
information through a series of questions. When this interactive mAkEblk session is completed, 
the BLOX utility automatically compiles file exchange . f to create ExchAngE, which is the FORTRAN 

executable t hat implements the specified exchange from either the working file to the master file 
or vice versa. 


iuv. ai n y . 




The utility then attempts to execute ExchAngE. If the restart files are very large, 
defaults may not permit interactive execution of ExchAngE. In these cases, the user will need to 
submit ExchAngE in the working directory as a batch job according to local system protocol. A 
sample script file is shown in screen 109. 


# QSUB -IT 100 

# QSUB -1M 20mn 

cd work_dir 
ExchAngE 


Screen 109. 
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Here, it is specified that the size of the executable is less than 20 megawords and requires less 
than 100 seconds of CPU time (screen 110). 

NOTE: The utility BLOX has no effect on the executable laura. Changes in bound- 
ary conditions or working block dimensions associated with reblocking, if necessai v, 
are implemented with the utility PRELUDE. 


VERSIONS AURA. 4.1 


H0MER=$H0ME/$ VERS I ON 

rm mAkEblk exchanged 2> /dev/ null 

In -s $H0MER/mAkEblk . 

mAkEblk 

rm mAkEblk 

if [ ! -f exchange. inc ]; then 

mv exchange. tmp exchange . inc 
In -s $H0HER/ exchange. f . 
f77 exchange. f -o ExchAngE 
rm exchange. f 


else 


diff exchange. tmp exchange . inc > /dev/null 2>&1 

if [ $7 -ne 0 ]; then # if files differ... 

mv exchange. tmp exchange. inc 
In -s SHOMER/ ex change. f . 
f77 exchange. f -o ExchAngE 
rm exchange. f 

else 


rm exchange. tmp 


fi 


fi 


Screen 110. 



if [ grep machine $HOMER/DEFAULTS | awk ’{print $1} ,<M = "o" ]; then 
ExchAngE > errout 2>&1 

if [ '"wc -1 errout | awk ’{print $1}’ <M = M i" ] ; then 

. . , ech ° " AB0RT: Job is too large to run interactively on this ma 

chine." 

echo " V ExchAngE’ must be submitted as a batch job." 


cat echout 


echo " 


. . .Completed \‘ ExchAngE’ procedure 1 


rm echout 2> /dev/null 


ExchAngE 


echo " 


. . .Completed \‘ ExchAngE’ procedure" 


for FILE in TWALL.in TWALL. MASTER; do 

if [ i wc -c $FILE | awk ’{print $1}’ <M = "0" ]; then 
rm $FILE 
f i 

done 


Screen 110. Concluded. 
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Appendix H 


Structure of CUSTOMIZE 


As discussed in chapter X. the philosophy behind the file directory structure of LAURA is 
that the hulk of the LAURA algorithm can be packaged such that, the constituent files do not 
change from one application to the next. These files reside in the users “$HOME/LAURA .4 . 1 
directory. For advanced applications. LOCAL copies of these files can be created (appendix K) 
and modified. Subsequent compilations of LAURA will use these local files rather than the 
$HOME/LAURA .4.1 versions. 

A LOCAL version of file lfn will only be used in the current working directory. There may be 
occasions when the user would like to use this tailored file in directories other than the current 
one. The obvious approach is to copy the LOCAL file to the other directory- Rather t han copying 
a LOCAL file from directory to directory, however, the command 

(CUSTOMIZE lfn) 

can be used to place this LOCAL file in the $HOME/LAURA .4. 1/CUSTOM directory. Any future 
compilations of LAURA (from any working directory on this machine) will use this 
SHOME/L AURA. 4. 1 /CUSTOM file in lieu of the $H0ME/LAURA.4. 1 version. 

Several stops must be performed by this command to create a CUSTOM file. First , t he write- 
protection for "$HOME/LAURA .4.1" must be removed, and the subdirectory CUSTOM created as 
follows ( screen 111): 


VERSI0N=LAURA.4. 1 

FILE=$1 

chmod 700 $H0ME/$VERSI0N # make CUSTOM read/write/execute 

if [ ! -d $H0ME/$ VERS ION/ CUSTOM ] ; then # if subdirectory CUSTOM DNE. . . 

mkdir $H0ME/$VERSI0N/CUST0M; # ...create it 

fi » 

chmod 700 $H0ME/$VERS ION/ CUSTOM # make CUSTOM read/ write/execute 


Screen 111. 

Next, the LOCAL file is moved to CUSTOM. However, if a CUSTOM version of lfn already exists. 




and the two files are identical, the LOCAL file is simply removed. On the other hand, if a CUSTOM 
version of lfn already exists, and the two files differ, the user is given the option to update the 
CUSTOM file (screen 112): 


# if file DNE in CUSTOM... 
if [ ! -f $HOME/$VERSION/CUSTOM/$FILE ] ; then 

mv $FILE $HOME/$VERS ION/CUSTOM # move it there, * 

chmod 400 $HOME/$VERSION/CUSTOM/$FILE # make it read only 

echo "File \‘$FILE’ added to \$H0HE/$VERSI0N/CUST0M. " 
echo ’’Future compilations will use this file in lieu" 
echo "of the \$H0ME/$VERSI0N version of \‘$FILE\" 

else # 

diff $FILE $H0ME/$VERSI0N/CUST0M/$FILE > /dev/null 2>ftl 

if [ $? -ne 0 ]; then # if files differ... 

echo "File \‘$FILE’ already exists" 

echo "in \$H0ME/$VERSI0N/CUST0M. Update (y/n)?" 

read ANSWER 

if [ "SANSWER" = "y" -o "$ANSWER" « "Y" ] ; then 

mv ~f $FILE SHOME/ $VERSI0N/ CUSTOM # move to CUSTOM 

chmod 400 $H0ME/$VERSI0N/CUST0M/$FILE # make read only 

echo "File \‘$FILE» updated in \$H0ME/$VERS ION/CUSTOM. " 
echo "Future compilations will use this in lieu " 
echo "of the \$H0ME/$VERSI0N version of \‘$FILE’." 

fi # 

else # else. . . 

rm -f $FILE # . . .remove it 

echo " No change in SFILE in \$H0ME/$VER*I0N/CUST0M" 

fi # 


fi 


# 


Screen 112. 


The final step is to reestablish write protection for the “$H0ME/LAURA .4.1” files as follows: 


chmod 500 $H0ME/$VERSI0N/CUST0M # make read/execute 

chmod 500 $H0ME/$VERSI0N # make read/execute 
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Appendix I 

Structure of INITIALIZE 


As discussed in sect ion 9.1.1, the LAURA restart, file (RESTART, in) consists of flow field prop- 
erties (velocities, temperatures, and densities) for each cell, along with the grid. The INITIALIZE 
script allows the user to use an externally generated grid with LAURA. This utility creates a 
RESTART. in file from a grid file in PL0T3D format. The command 

(INITIALIZE lfn) 

takes a grid file If n. initializes its flow field to free- stream values, and outputs the file RESTART . in. 

NOTE: INITIALIZE gleans information from several files that are created by stArt. 

1 heiefoie, PRELUDE must be executed before an externally generated grid can be 
initialized. 

In laura. the grid must be oriented such that y = 0 is the plane of symmetry. The user can 
encounter externally generated grids with other orientations. Before running INITIALIZE, it is 
recommended that the user reorient the grid to conform to the examples shown in figures 2.1 
and 2.2. An alternative involves changing the definition of uinf. vinf. and trill f for laura and 
INITIALIZE (section 7.9.1). 

INITIALIZE uses the following procedure. First, it checks to see if the file RESTART . in exists. 
If so, the user is given the option to overwrite it as follows (screen 113): 
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VERS I ON=LAURA .4.1 


GRIDIN=$ 1 


if [ -f SGRIDIN ] ; then 


if [ -f RESTART. in ]; then 

echo " File \‘ RESTART. in’ already exists." 

echo " Do you wish to remove it (y/n) {n}?" 

read ANSWER 

if [ "SANSWER" = V -o ”$ANSWER" = "N" ] ; then 


else 

echo " ERROR: File \‘ SGRIDIN’ not found. M 
exit 0 


Screen 113. 

The species indices are obtained from file species_strt (which is created by stArt). If a LOCAL 
version of species_strt exists, that file is used. This information is placed in file flowinit .in. 
as shown in screen 11 1: 


H0MER*$H OME/ $ VERS I ON 
rm flowinit. in 2> /dev/null 

if [ Ml ls STRTf iles/species. strt species . strt ‘ " ]; then 

if [ ! -f species. strt ]; then 

In -s STRTf iles/species. strt . 
fi 

grep M = M species. strt I awk -F= ’print $2’ > flowinit. in 

if [ "‘Is -It species. strt I grep STRTf iles‘" ]; then 
rm species. strt 
f i 

else 

echo "ERROR: File \ ‘ species . strt » not found." 

fi 


Screen 114. 
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T| ,e mnnho'- of species is obtained from file parameters (which is created bv 
a LOCAL version of parameter_strt exists, that file is used. This value is added 

flowinit. in (screen 115): 


stArt). If 
to the file 



if [ Is STRTf iles/parameter . strt parameter . strt 1 " ]; then 


if [ ! -f parameter. strt ]; then 

In -s STRTf iles/parameter .strt 
fi 


grep M ns - fl $FILE | awk -F- 'print $2* » flowinit. in 

if C Mt ls -It parameter. strt | grep STRTf iles<" ]; then 
rm parameter .strt 
fi 

else 


echo '’ERROR: File \ ‘parameter . strt ' not found.' 1 


rhe angle of attack, angle of yaw. free-stream temperature, and free-stream velocity are obtained 

from file DEFAULTS (which is updated by stArt). This information is added to file flowinit in 
( screen llG): 


if [ 

-f DEFAULTS ] ; 

then 


grep attack 

DEFAULTS » flowinit. in 


grep yaw 

DEFAULTS >> flowinit. in 


grep tinf 

DEFAULTS >> flowinit. in 


grep vinfb 

DEFAULTS >> flowinit. in 

else 




echo "ERROR: 

File \ £ DEFAULTS’ not found." 

fi 




Screen IIG. 





The program ArrAy reads the prescribed computational block dimensions from file lfn. If a 
larger dimension is required than that specified in the $HOME/LAURA .4.1 version of flowinit me 
a LOCAL version of flowinit . inc is created, and flowinit. f is recompiled. Next. flOwInlt is 
executed to initialize the grid based on the values in flowinit. in. The resultant flow held is 
output to create RESTART, in (screen 117): 


rm grid. in 2> /dev/null 


In -s SGRIDIN grid. in 

SHOME/SVERSION/ ArrAy # create LOCAL flowinit . inc , if necessary. 


if [ M ‘ls flowinit . * 2> /dev/null ]; then 

echo n < LOCAL \ l flOwInlt’ executable will be used 

if [ "‘Is -t f 1* I awk 9 {print $1}* I head -1“' = "flOwInlt" ]; then 

echo m < LOCAL \‘ flOwInlt’ executable is up to da 

> M 

else 

ech0 » < Creating LOCAL \‘fl0wlnlt’ executable 

>" 

if [ -d SHOMER/CUSTOM ] ; then 

for FILE in ‘cd SHOMEB/CUSTOM; Is flowinit.* 2> /dev/ 


te 


null ‘ ; do 

if [ ! -f $FILE ] ; then 

In -s $HOMER/CUSTOM/$FILE . 
f i 

done 
f i 

for FILE in ‘cd $H0MER ; Is flowinit.**; do 
if [ ! -f $FILE ] ; then 

In -s $HOMER/$FILE . 
fi 

done 

FC flowinit. f -o flOwInlt 
for FILE in ‘Is flowinit.**; do 

if [ ”‘ls -It SFILE I grep LAURA ]; then 
rm SFILE 
fi 


else 

fi 


done 

fi 

rm f lOwInlt 2> /dev/null 


Screen 117. 
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if [ ! -f f lOwInlt ] ; then 

if [ -d SHOMER/CUSTOM ] ; then 

if [ "‘cd SHOMER/CUSTOM; Is floninit.* 2> /dev/null‘" ] ; then 

echo " < CUSTOM \‘fl0wlnlt’ executable wi 

11 be used >»* 

( cd $H0MER/ CUSTOM ; 
rm ♦trace 2> /dev/null; 

if [ Mt ls -t fl* I awk ’{print $l}> | head -l‘ M = "flOwI 


nit" ] ; then 


table is up to date 


CUSTOM \ ‘ f lOwInlt , execu 


It ’ executable 


echo " < Creating CUSTOM \‘fl0wln 

> M ; 

chmod 700 $H0MER; 
chmod 700 $H0MER/CUST0M; 

for FILE in ‘ cd SHOMER; Is flowinit.+‘; do 
if [ ! -f SFILE ] ; then 

In -s $H0MER/$FILE . ; 
fi 

done ; 

FC flowinit.f -o flOwInlt; 
for FILE in ‘Is flowinit.+‘; do 

if [ "‘Is -It $FILE | grep LAURA*" ]; then 
rm SFILE; 
fi 

done 

chmod 500 SHOMER; 
chmod 500 SHOMER/CUSTOM; 

fi ) 

In -s SHOMER/CUSTOM/ f lOwInlt . 

rm $HQMER/CUST0M/f lOwInlt 2> /dev/null 
if [ ! "‘Is SHOMER/CUSTOM <M ]; then 
chmod 700 SHOMER 
chmod 700 SHOMER/CUSTOM 
rmdir SHOMER/CUSTOM 
chmod 500 SHOMER 
fi 

In -s $H0MER/f lOwInlt . 


In -s $HDMER/f lOwInlt . 
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f lOwInlt 


if [ Mt ls -It flOwInlt I grep LAURA 4 " ]; then 
rm flOwInlt 
fi 

rm grid. in 2> /dev/null 
exit 0 


Screen 117. 


# Remove flOwInlt if 

# it’s just a sym-link 

# to default flOwInlt. 


Concluded. 
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Appendix J 

Structure of KEEPER 


u„. aiiows ti,p ,,s " *° •***■«* ° r »,«i ™u . *> i„ ^ iy Pi „ K 


Bark lips for the master files RESTART . MASTER and TWALL. MASTER). whirl, oxis! 

eonipiitational hlorks are employed in the solution procedure. am also rmatnl. If a previ » 
backup hie is en countered, the user Is given I lie option of updating it (screen I IX): 


BACKUP= ’backup ’ 

echo Enter desired suffix for these backup files {SBACKUP} * M 
read BACKUP J * 

for FILE ‘Is in RESTART. in TWALL. in *. MASTER 2> /dev/null‘; do 
if C -f SFILE . SBACKUP ] ; then 

n} ,„ eCh ° " L0CAL file \‘$FILE. SBACKUP’ already exists. Update (y/n) { 

read ANSWER 

if [ "SANSWER" » "y" -o "SANSWER" = "Y" ]; then 
rm $FILE. SBACKUP 
cp SFILE SFILE. SBACKUP 

echo "File \‘ SFILE’ copied to \‘ SFILE. SBACKUP’" 
f i 


cp SFILE SFILE. SBACKUP 

echo M File \* SFILE’ copied to \ ‘ SFILE. SBACKUP ’ 


Screen 11S. 
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NOTE: These LAURA restart files (RESTART . in and TWALL . in) are only ovei writ- 
ten at the conclusion of a successful run. so ‘'backing up” t hese files is not mandatory. 
In some cases, however, doing so can provide peace of mind for the user. 
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Appendix K 

Structure of LOCALIZE 


As discussed in chapter 8, the philosophy behind the file directory st ructure of LAUR A is t hat 
the bulk of the LAURA algorithm can be packaged such that the constituent files do not change 
from one application to the next. These files reside in the user's $H0ME/LAURA.4. 1 directory. 
For advanced applications, LOCAL copies of these files can be created with the command 

(LOCALIZE lfn) 

and modified. Subsequent compilations of LAURA will use these LOCAL files rather than the 
$HOME/LAURA . 4 . 1 versions. 

First, LOCALIZE checks to see if a LOCAL lfn already exists. If so. the user has the option to 
abort the request, or continue (and overwrite the existing LOCAL file) as shown in screen 119: 


VERSIQN=LAURA .4.1 

FILE=$1 

if [ -f $FILE ] ; then 

echo " LOCAL file V$FILE’ already exists. Overwrite (y/n) {n}?” 
read ANSWER 

else 

ANSWER^ ’y * 
fi 


Screen 119. 

If the request is not aborted, LOCALIZE checks the following directories for the existence of 
lfn: 

• $H0ME/LAURA.4. 1 — the directory containing baseline files ( ,F, .FOR. and . inc suffixes) 

• STRTfiles the directory containing files created by stArt( .strt suffixes) 

• FORTRAN — the directory containing pure-FORTRAN files ( .f suffixes); this directory, and the 
files it contains, are created by the command 

(make fortran) 
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which is discussed in section 8.3. 

LOCALIZE copies the file If n from its directory of residence and makes it user-writable (screen 120): 

EXIST=0 

if [ -f $H0ME/$VERSI0N/$FILE ] ; then 

if [ -d $H0ME/$VERSI0N/CUST0M ] ; then 

if [ -f $H0ME/$VERSI0N/CUST0M/$FILE ] ; then 

echo " WARNING: CUSTOM version of file \‘$FILE’ exists." 
fi 
fi 

EXIST=1 

cp $HOME/$VERSIQN/$FILE . # copy installed version 

# to LOCAL directory, 

chmod 600 $FILE # and make it user-writable 

fi 

if [ -f STRTf iles/$FILE ] ; then 
EXIST=1 

cp STRTf iles/$FILE . 
chmod 600 SFILE 
fi 

if [ -f F0RTRAN/SFILE ] ; then 
EXIST=1 

cp FQRTRAN/SFILE . # copy file from FORTRAN to LOCAL dir 

fi 

Screen 120. 

With any future compilations of LAURA (from this working directory), this LOCAL file will he 
used in lieu of the $H0ME/LAURA . 4 . 1 or CUSTOM (appendix H) versions. 


# copy file from STRTf lies 

# to LOCAL directory, 

# and make it user-writable 
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II file lfn does not exist in any of these directories, t he following error message is sent to the 
screen, and the request is aborted (screen 121): 


if [ "SEXIST" = "0" ] ; then 

echo " ERROR: File ^SFILE’ does not exist in the " 

echo " \$H0ME/$VERSI0N, STRTfiles, or FORTRAN directories." 

else 

echo " LOCAL copy of the \$H0ME/$VERSI0N version of \ ‘SPILE* created." 
echo 11 Future compilations will use this LOCAL file in lieu of the" 
echo " \$H0ME/$ VERSION or CUSTOM versions of \‘$FILE>." 

fi 


Screen 121. 
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Appendix L 

Structure of RESTORE 


The script RESTORE allows t he user to reconstruct a working directory from a file lfn created 
with the ARCHIVE command (appendix F). First, create a new working directory. Next, move 
lfn (the tarf ile created by ARCHIVE) to that directory. While in the new directory, type the 
command 

(RESTORE lfn) 

and the following procedure will be executed. The tarfile is unloaded as shown in screen 122: 


TARFILE=$1 
tar xf STARFILE 


Screen 122. 

The DEFAULTS and INPUTS file are retrieved (screen 123): 


if [ -d IN ] ; then 

for FILE in ‘Is ~t IN‘; do 
mv IN/SFILE . 

done 

rmdir IN 


Screen 123. 
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Tlu> file conv.out is retrieved (screen 124): 


if [ -d CONV ] ; then 

mv CONV/conv . out . 
rmdir CONV 
fi 


Screen 124. 

Any input files for laura (RESTART . in. assign_tasks. transition. TWALL . in. and variabletw) 

that were saved are retrieved (screen 125): 


if [ -d CONTROL ] ; then 

for FILE in ‘Is -t CONTROL* ; do 
mv CONTROL/$FILE . 

done 

rmdir CONTROL 


Screen 125. 

If the master input files ( RESTART . MASTER and TWALL . MASTER) were saved, they are restored 
(screen 120): 


if [ -d MASTER ] ; then 

for FILE in 1 Is -t MASTER ‘ ; do 
mv MASTER/$FILE . 

done 

rmdir MASTER 


Screen 120. 







II any LOCAL files were saved, they are reinstated (screen J27): 


if [ -d LOCAL ] ; then 

for FILE in ‘Is -t LOCAL'; do 
mv LOCAL/$FILE . 

done 

rmdir LOCAL 
fi 


Screen 127. 

NOTE: If any CUSTOM files were saved, they are saved in a CUSTOM subdirec- 

tory below this LOCAL directory. They are not automatically reinstated in the 
$HOME/LAURA .4. 1/CUSTOM directory to avoid the possibility of overwriting existing 
CUSTOM files, fo restore them as CUSTOM files, the user should cd to CUSTOM and use 
(lie CUSTOMIZE command (appendix If) on the individual files. 

I he following steps are required to pick up the solution where it left off before archival; 

• Tvpo the command 

(prelude imputs) 

to create the required subdirectories and source files ( .strt suffixes). 

NOTE: Be sure to preserve the existing RESTART. in, data, and conv.out files 
when prompted. 

• Type the command 



to compile the LAURA source code and create the laura executable 
• Type the command 

(laura < data) 


to advance the solution. 






Appendix M 

Structure of SIZEIT 


This script allows t he user to estimate the memory requirements for t he current application. 

bv simply typing the command 

(sizeit) 

Both PRELUDE and Makefile execute this script as part of their proceduies. 

The script SIZEIT serves as the front end for sIzEIt. which is the executable for the FORTRAN 
routine sizeit. f. This routine solves equation (11.8), as well as equation (11.9) or (11.10). to 
determine memory allocations for each task defined in file assign_tasks. If file assign_tasks 
is not found, a single task with sweeping in the /.-direction is assumed. 

First, the size of the laura executable is determined (excluding the overhead associated wit li 
the use of multitasking and/or the solid-state-device), as shown in screen 128: 


if [ -f laura ]; then , 

^ [ m< 1s _ t sTRTf iles/* . strt *.strt * . inc *.F* *.f laura 2> /dev/null | 

auk ’( print $1}’ I head -1‘" = "laura" ]; then 

size laura I tail -1 I awk ’{print $4} ' > sizeit. m 


else 
f i 


echo "0 H > sizeit. in 


else 

echo "0" > sizeit. in 


fi 


Screen 128. 
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Next, the information required by sIzEIt is gathered from files created by PRELUDE. T 


sIzEIt is executed to determine any additional 


results 


are saved in file ECHOSIZE and echoed to I lie s 


memory requirements for the current job. The 


screen (screen 129 ): 


if [ " Is -t STRTf iles/parameter . strt parameter . strt 2> /dev/null‘ M ]; then 

if [ ! -f DEFAULTS ]; then 

In -s $HOME/$VERSION/DEFAULTS . 
fi 

if i ! "‘Is HEADER. strt 2> /dev/null <M ]; then 
In -s STRTf iles/HEADER. strt . 
fi 

if C "‘grep NAVIER HEADER . strt ‘ M ]; then 
echo "2" >> sizeit.in 

else 

echo "0" >> sizeit.in 
fi 

if [ " l ls -It HEADER. strt I grep STRTf iles‘" ]; then 
rm HEADER. strt 
fi 

if [ n ‘grep machine DEFAULTS | awk: , {P r i nt $ 1 } ? * M = M 0" ] ; then 

In -s $H0ME/$ VERS ION/e valvar am. f . 

for FILE in issd_assn. strt parameter . strt ; do 
if f ! -f $FILE ] ; then 

In -s STRTf iles/$FILE . 
fi 

done 

FC eval.param. f ~o EvAl_pArAm 2> /dev/null 

for FILE in issd_assn. strt parameter . strt ; do 

if [ " ‘Is -It $FILE 1 grep STRTf iles‘ M ]; then 
rm $FILE 
fi 


EvAl_pArAm >> sizeit.in 
rm eval_param.f EvAl_pArAm 


Screen 129. 
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rm -f ECHOSIZE 2> /dev/null 


$H0ME/$VERSI0N/ sIzEIt 

if [ ”‘wc -1 ECHOSIZE I ask ’{print = "0” ]; then 

rm ECHOSIZE # rm ECHOSIZE if it is empty 

else 

chmod 400 ECHOSIZE 
cat ECHOSIZE 
f i 


rm sizeit . in 


if [ " £ ls -It DEFAULTS I grep LAURA tM ]; then 
rm DEFAULTS 
f i 


# Remove DEFAULTS if 

# it’s just a sym-link 

# to default DEFAULTS. 


else 


echo "ERROR: File \‘parameter .strt 5 not found.' 1 


fi 


Screen 129. Concluded. 
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Appendix N 

Structure of XCUSTOM 


The command 


nullifies the 


(XCUSTOM lfn") 

(CUSTOMIZE lfnl 

command. In other words, it moves the file lfn from the CUSTOM directory (appendix II 

i Th , U r °? l ! na " d perforn,s thc foI,owi,, R lask «- First, the write- piot eci 
$H0ME/ LAURA .4.1. the subdirectory CUSTOM, and the file lfn must be removed Then 

Si^ih L ° CAL <,ireft0ry - Th ° fhlal 8t<,p is to "^taWish write protection 
$HOME/LAURA .4 . 1 files (screen 130): 


) to the 
ion for 
the file 
for the 


FILE=$1 
if [ -f 


else 

fi 


# make dir read/write/execute 

# make dir read/ write/execute 

# make file read/write 


$HOME/$VERSION/CUSTOM/$FILE J ; then 

chmod 700 $H0ME/$VERSI0N 
chmod 700 $HDME/$VERSI0N/CUST0M 
chmod 600 $H0ME/$ VERSI 0N/CUST0M/$FILE 

fflV $H0ME/$VERSI0N/CUST0M/$FILE . # move file to LOCAL directory 

echo "CUSTOM \‘$FILE > moved to LOCAL directory." 

echo "Unless removed, future compilations will use this 

echo "LOCAL version of \‘$FILE , . M 

if C ! "‘Is -t $H0ME/$VERSI0N/CUST0M‘ " J ; then * if dir is now empty 
rmdir $H0ME/$VERSI0N/CUST0M 

else 

chmod 500 $H0ME/$VERSI ON/CUSTOM 
fi 

chmod 500 $H0ME/$VERSI0N 


# . . .remove it 

# else . . . 

# . . .make read/execute 

# 

# make dir read/execute 


echo "File \‘$FILE’ does not exist in \$HOME/$VERSION/CUSTOM. " 


Screen 130. 
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Appendix O 


LAURA Algorithm 


Nomenclature 

Nolo that hold face, lowercase symbols refer to vectors in parameter space. Boldface, up- 
percase symbols refer to matrices in parameter space. An arrow over a lowercase symbol refers 
to vectors in physical space, with (.r, j/. ‘^coordinates. With the exception of the reaction rate 
coefficients and temperatures, all variables are nondimensional. 


a 

A 

B 


C.H 

c s 

Ds 

E 

< s 

fy 

f V.x 

f 

g 

// 

h 

h 

V ,.s 

h'b.r 

h r 
f 

It. hr I ; 
M l 

Mljnv 
Ml. vis 
Ml.src 
M* 

m 


froze' ii sound speed, nondimensionalized bv V, x , 

Jacobian matrix of g with respect to q 

Jacobian matrix of h with respect to q 

specific heat for translational-rotational energy 

specific heal for vibrational-electronic energy 

mass fraction of species .s 

average molecular speed of molecule s 

effective diffusion coefficient of species .s 

total energy per unit mass of mixture, nondiniensionalized by 

energy per unit mass of species 

mixture vibrational-electronic energy per unit mass 

vibrational-electronic energy per unit mass of species .s 

flux vector in (’artesian space 

inviscid component of flux vector relative to cell face 
total enthalpy per unit mass of mixture 
viscous component of flux vector relative to cell face 
enthalpy 

ent halpy per unit mass of species .s 

vibrational-electronic enthalpy per unit mass of species s 

backward reaction rate coefficient for reaction r 

forward reaction rate coefficient for reaction r 

unit vector tangent to computational cell wall {T- m = 0) 

components of / in x - , f/-, ^-directions, respectively 

point-implicit Jacobian of flux terms 

point -implicit. Jacobian of inviscid terms 

point -implicit Jacobian of viscous terms 

point -implicit Jacobian of source terms 

molecular weight of species s 

unit vector tangent to computational cell wall (T m ~ 0) 


m 



m T . m y , 
iV 

JVr 

Jv, 

w 


n 

w 2 -, n- 
?7 
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P 
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ft 
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r /,. 
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r 
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Voo 
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,r 
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components of m in ar-, */-, ^-directions, respectively 

iteration level index 

number of reactions 

number of species 

normal distance 

unit vector normal to computational cell wall ( u • / = n • m = 0 ) 
components of n in ;r-, y -, --directions, respectively 
number density 

number of iterations between Jacobian updates 

number of iterations between transport property updates 

pressure 

divergence of radiative flux 
vector of conserved variables 
universal gas constant 
backward reaction rate for reaction r 
forward reaction rate for reaction r 
matrix of left eigenvectors of A 
right-hand-side residual vector 
reaction rate 

relaxation factor used with inviscid Jacobian matrices 
relaxation factor used with viscous Jacobian matrices 
arc lengt h 

arc lengths in /-, m-, /7-directions, respectively 
t r a n s 1 at ion al - r o t at ion al t e n i p e r a t u re 
vibrational-electron-electronic excitation temperature 
time 

velocity component in the ?7-, /-, and m-direetions, respectively 
velocity components in ,r-, //-, ^-directions, respectively 
free-stream total velocity, m/s 
Cartesian coordinates 
mole fraction of species a 

stoichiometric coefficient for reactants in reaction v 

In general, fi = 0p/0(pE); for perfect gas, this reduces to ji = 7 - 1 

stoichiometric coefficient for products in reaction r 

ratio of specific heats 

Op/ Opr 

parameters for defining minimum eigenvalue 

frozen thermal conductivity for translational-rotational energy 

frozen thermal conductivity for vibrational-electronic energy 

0 for first-order; 1 for second-order approximation to inviscid flux 

eigenvalue of A 

restricted eigenvalue of A 

diagonal matrix of eigenvalues of A 

mixture viscosity 

reduced mass of species s and j 

computational coordinates 

mixture density 

density of species 
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(7 

0s 

T 

< T s > 

f\' 

0 

\ 

U) 

n 


roll face area 


cross section of species * for translational- vibrational 
shear stress 


energy exchange 


vibrational relaxation time defined in equation (().">(>) 
lelaxation time defined in equation ( O.o.'i ) 

Op/d(fH V ) 

dummy variable for (. i/. or ( 
vector of source terms 

mass production rate of species * per unit volume 
vibrational-electronic energy source term 
cell volume 


Subscripts: 


/. ■/, A 

i- ./• A- 

L 

I 


\ 


electron 

indices of cell centers in (-directions. respectively 

indices of cell walls in (-. //-. (-directions, respectively 

dummy index for cell center 

dummy index for cell wall 

reaction r or species r 

species ,s 

vibrational-electronic 


Superscripts: 

iteration level index 

relating to the thin-layer approximation 


U„dat ° f ° IIOWinR a ! g ? riUim (leSrri,,tio " is substantially the same as that provided in reference 12 
Updates are provided as appropriate for LAURA. " (e 


0.1. Finite- Volume Fundamentals 

la " S a - |,li0 " *° * - ‘I- computational 

///&« + //*•** //a 


dtt 


( 0.1 


In equation (0.1) the first term describes the time rate of change of conserved quantity q in 

wailval'l tt n U !i SOf ° ml term deSCribes TO “vective and dissipative flux f through thelell 
I ' U T| H . !" eri " arcou " ts for sources or sinks of conserved quantities within t he control 
volume I he third term is identically zero for perfect-gas flows, hut it is requireTf >r flow 
chemical or thermal nonequilibrium. 11 

TI,o finite- volume approximation equation (0.1) for a general, unstructured grid is written 


V) (qi)) 


bt 


Ml 

+ c 

m = 1 


n») (?m 


( 0 . 2 ) 


185 



where 


(*)q = q n+1 - q” and t>t - t' ,+l - t“ 

and fir. is constant with respoct to ti.no. Further. Ml is the number 

volume Q and subscript m refers to cell face m with surface area a m . lhe quant.it> n m is a 
mi cL“ rn.al to rill face ,,, in a direction facing away front the cell center. I he , legend 
variable q is defined at. cell centers. The independent variables », ,. and * are tie) I at cell 

""tW linite-volutue approximation to e<|nation (0.1 1 for a rectangularly ordered, structured 
grid is written 

r^qft- 


L it J I.J.K 


+ ?,+ 1 * + l ~~ ^ 




■i+1 * Wi+l^i + l 

+ [4+i • " j + 1 ff i+> - 4 • /.A 

+ [4+1 • «fc+i^fc+i - 4 • iiktTk] u = P 9 ]/,./,A‘ 


(0.3) 


A shorthand notation for equation (0.3) that will bo used throughout this paper follows: 


+ Z K'+i • ,7 '+i (T '+ i - = 

Jt- /=«.;,* L 




(0.4) 


Note in equations (0.2) to (0.4) that the uppercase integer variables /, J, h , , a 
computational coordinates at the cell centers, and the lowercase integer variables , J. k, '• dIU 
denote the cell faces or the cell corners. For example. cr u , K refers to the cell wall corresponding 
to indices / - i ./, A' ( fig. 0 . 1 ). In the shorthand notation ol equation (0.4 ) the integer varia ) < 

) -:ted as a generic index for ij, or k. This notation is convenient because most of the 
formulations for quantities at the cell faces are independent, of the coordinate direction 
geometric quantities ft, «r, and « are easily derived given the ( artesian coordinates of the 

corners Details are found in appendix A of reference 2. 

The formulations that follow are based on a rectangularly ordered, structured grid. A . s - 
order-accurate formulation of the inviscid equations on a structured grid is .dent, cal to the fo,- 
mula.ion on an unstructured grid. The modifications required to achieve second-order accuracy 
on an unstructured grid are no. addressed in this paper. However, note that the formulations 
for obtaining seconiorder accuracy only involve modifications to the r,g ht-hand-s.de residua 
vector. The point-implicit relaxation procedure that will be defined by the formula,, on of til 
left-hand side matrix is independent of grid structure. Consequently much of tked^pm 
that follows will carry over to unstructured grid formulations, a, the paper by lhareja et al. 

(ref. 33). 


0.2. Conservation Equations 

The inviscid, viscous, and source term contributions to the complete conservation laws are 
considered separately for convenience. Let 

4-n, = gi + h, (0 ’ 5) 

where g, defines the inviscid terms and h, defines the viscous terms. The finite- volume fonnu- 
lation of the conservation laws is now expressed as 


+ V [gi+,^1+1 + Z [h/+,^+i -h/a,] = [W] L 

\l l=itj<k 


( 0 . 6 ) 
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j+2 -i- 4 -1— 1 — - 1 



1-1 1 i+1 i+2 i+3 

f igure 0.1. Cell indexing system with cell corners defined by lowercase letters and cell centers 
defined by uppercase letters. 

In the case of a reacting gas flow in which thermal nonequilibrium is modeled using a two- 
temperature approximation, the vectors q. g, h, and Cj are defined as 



p s V 

pUu + pn x 
_ PUV + pity 
° pUw + pit- 
pV H 
pVey 


( 0 . 8 ) 
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Table 0.1. Species Indices 
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species 
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0, 
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N+ 

0+ 

Nt 

0+ 

N() + 

e” 



-T, ir 


n y 


[0.9) 


01 oi \ , n Qy* 

■«r„ - i-r„» - u'T„~ - - nv-^ - f'L.KD. ^ 


dl r \ - , n <h s 

-nv-r- -Pl^ h v, s O s -— 

('•Si s _l l/f, n 


0 

0 

0 

Q rad 

L u?v' 


( 0 . 10 ) 


The first element of the vectors defined in equations (0.7) to (0.10) describes the species 
conservation; the next three elements describe x , y. and _ momentum conservation; the fifth ele- 
ment describes total energy conservation; and the sixth element desriibes vibi ational-electronic 
energy conservation. The present model considers the N s - 11 species shown in table 0.1. 

Consequently, the vectors defined in equations (0.7) to (0.10) are composed of a total of lb 
elements. Implicit in the use of a vibrational-electronic energy equation is the assumption that 
the partition of energy in the vibrational, bound electronic, and free-electron modes among all 
species can be described by a single temperat ure Ty. This approximation is based on rapid equi- 
libration of vibrational and electronic energy and electron translational modes (refs. 0 and Tl). 
The translational and rotational energy modes of heavy particles are assumed to be fully excited 
and described by temperature T. 

The thermochemical nonequilibrium model is described in detail in reference 1. Some specifics 
on its formulation are given in a later section, but a brief overview is given below. The reactive 
source terms for the species conservation equations are denoted by The radiative energy 
transport term Q ra(1 can be treated as a source term in the total energy equation. Although 
its effects are not included in the baseline LAURA algorithm, one approach for including it is 
discussed in section 11.6. Finally, the vibrational-electronic energy source term vy accounts 
for the mechanisms by which vibrational-electronic energy is lost or gained caused by collisions 
among particles in the cell. These mechanisms include the energy exchange (relaxation ) between 
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vibrational and translational modes caused by collisions within the cell, the vibrational energy 
lost or gained because of molecular depletion (dissociation) or production (recombination) in the 
cell, the electronic-translational energy exchange because of elastic collisions between electrons 
and heavy particles, the energy loss caused by electron impact ionization, t he rate of energy 
loss caused by radiation caused bv electronic transitions (a subset of Q raA in the total energy 
equation (section 0.5.3), and a term related to the work done on electrons by an electric field 
induced by the electron pressure gradient minus the flow work caused by electron pressure. 
I he electron pressure flow work is normally considered as part of the electronic ent halpy in 
the inviscid (convective) portion of the flux balance. Moving the electron pressure from' the 
convective term to the source term simplifies the expressions for eigenvalues and eigenvectors of 
the Jacobian of t he inviscid flux vector. 


0.3. Formulation of Inviscid Terms 

I he inviscid flux vector at cell face / is defined 


Si = 



[g L.l + gt-1,/] 


i 


2 (\«) i 


R/IA, 



( 0 . 11 ) 


where 

Slj [f L »/] ]NV 

l lie first term in braces is a second-order-accurate base approximation for g/ . The second 
term in braces provides the upwind-biased numerical dissipation. It is a first-order dissipation 
when 6 = 0. It is a second-order dissipation when 0=1. The term ( \n), is a shorthand notation 
for V\ • ?q, and can be thought of as the inverse of the projected distance between cell centers 
L and i. 1 in a direction normal to cell face /. It is defined in equations (0.69) to (0.71) in 
section O.i. I he variable \ is a generic computational coordinate running in the direction of 
increasing generic index /,. 

The vector s/ is defined 


s/ - (\n) l R, 1 (q L - q z _i) (0.12) 

The matrix R ; 1 in equation (0.12) and the matrices R; and A/ in equation (0.1 1 ) are related 
t° tll( ' Jacobian of the inviscid flux vector g with respect to q in the following 


manner: 


A = 


Og 

dq 


= RAR -1 


(0.13) 


The matrix R/ is the matrix of eigenvectors of A/, and A, is a diagonal matrix containing the 
eigenvalues of A;. These matrices are defined in section 0.3.1. Their elements, which are required 
at a cell face, are evaluated as appropriate averages of quantities at adjacent cell centers. This 
averaging procedure is discussed in section 0.6. The matrix |A,| is a diagonal matrix containing 
the absolute values of the eigenvalues of A/ with constraints on the minimum allowed magnit ude 
of an eigen value given by 


' I'M, |A,|>2c, 

A 2 (0.14) 

~r~ + |A/| < 2 c/ 


The eigenvalue limiter q was first used by Harten (ref. 35) to prevent the formation of 
expansion shocks across a sonic line where one eigenvalue equals zero. Its application is critical 
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in blunt body flows to prevent instabilities (often in the form of reversed flows at the stagnation 
point); these instabilities occur in the stagnation region where the eigenvalue U t is near zero. The 
magnitude of €/, which is nondimensionalized by the free-stream velocity, is problem dependent. 
y ee e |. al. (ref. 36) has suggested a functional dependence of ti on the local values of sound speed 
and velocity. This relation has been adapted for use in the present work as follows: 

£/ = <*(a/ + |t'zl + |V/| + W|) 


where t 0 is a user-defined constant that generally varies from 0.01 to 0.3. The larger values of 
are required for flows with extensive stagnation regions, as in the case ol blunt-body flows. 
This limiter is called exclusively when the parameter iabseig = 0. 

Experience shows that, calculated convective heating levels are increased in the presence of a 
highly stretched grid across the boundary layer (cell growth factor greater than 1.2) and values 
of („ > 0.01. However, small values of ( u (t 0 < 0.01) applied in all coordinate directions can 
cause "instabilities. Several approaches to reduce the limiter across the boundary layer have 
been tried and documented in earlier versions of LAURA. The present approach, suggested by 
Netterfield (private communication, M. P. Netterfield, Fluid Gravity Engineering, Ltd.. U.K.. 
January 1993), changes the limiter for the following eigenvalue Up 


( l = max If c 


ir/i + li'/l + lw'/iho.ooH 


(0.16) 


This limiter is called when the parameter iabseig = 1 and viscous terms are active across t he cell 
face. Equation (0.15) is still used for the remaining eigenvalues. The parameter iabseig may 
need to be kept equal to 0 for some problems early in the relaxation process to survive difficult 
transients as the solution evolves. 

The antidissipative flux correction for second-order accuracy is formulated for each element 
of si in a symmetric mode (parameter iupwind = 0, default ) with 


Jim 


minmod 


2,s/+i , 2 si , 2.s/_i , 


(*;-! + - s f+i ) 
2 


(0.17) 


and in an upwind biased mode ( iupwind — 1 ) with 

4 im = Df minmod [.s;_i , $;] + D[ minmod [sj+i , *;] (0.18) 


A/" 


i 

Aj 

NJ 

and 

D ‘ = 2 

1 - rr- 

A/. 


The minmod function returns the argument of smallest absolute magnitude when all t he argu- 
ments are of the same sign, or it returns 0 if the arguments are of the opposite sign. The scheme 
reduces to first-order at cell faces where there is a sign change in the arguments of the minmod 
function. The symmetric limiter, derived by Yee (refs. 37 and 38) does not yield a strictly up- 
wind biasing on the formulation of the flux vector. It involves symmetric functions of gradients 
in the neighborhood of the cell face, and algorithms based on these limiters are referred to as 
symmetric total variation diminishing (STVD) schemes. The STVD schemes involve little extia 
programming work over simple first-order algorithms because most of the quantities required 
in their implementation are already available. The upwind limiter, following the form of Wang 
and Richards (ref. 39). retains the proper zone of influence for the inviscid flux calculation. 
Marginally better convergence rates have been observed for the upwind limiter compared with 
the symmetric limiter; however, the symmetric limiter appears less diffusive in nonequilibrium 
flows. LAURA defaults to the symmetric limiter. 
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Equation (0.11) can bo approximately linearized with respect to fiq, in the following manner. 
Define 

g/./. = - 2 [slV+gl-u] ~ I A/ 1 [(\n) / R / _l (q^ +1 — q^_ g ) — #s}* In *j (0.20) 

where superscript n refers to the current value at cell center /,. superscript n + 1 refers to the 
new value to be computed at cell center L. and superscript * refers to the latest available value 
at neighbor cell L - 1. The notation gjj refers to the inviscid flux through cell face / evaluated 
using the latest available data from cell center L - 1 and the predicted data at cell center I.. 
Elements of the vector s }' 111 are also computed using current data at cell centers L and L — 1. 
Substitute g u + A LJ t>q, for g“+‘ in e(|uation (0.20) to obtain 

Si.i. - Si + - ( Ay../ - |A/|) bq L 

whore 

I A/ 1 = R; | A/ 1 R“* 

In a similar manner, one can show that 


SJ+i.l - g/+i + t ( A/.,/ + [ + |A; +1 |)(^q L 


The point-implicit discretization of the inviscid part, of equation (0.0) can now be expressed 


XI [g/+../^/+. -guH = XI [gt+i^t+i - g/^t] 

l=i, l=i,j,k 

+ XI [(A/../+1 + |A/ +1 |)<t /+] — (A/,,/ - | A/ 1 ) cr/] <^qy (0.21) 

/= i.j.k 

An application of Stokes t heorem to the summation of A/ ,; and A^,.; +1 in equation (0.21) will 
show that 

XI [A/,2+t< T t+i — Aijafitiqj = XI < s f/..tNV • [v7/ +1 rr/ + i - = 0 

Therefore, equation (0.21) can be simplified as 

£ (g?+, ,L a t+i ~ Sl.L^l] = XI [gt+i a t+i - gi°i] + M/..i NV (>q L (0.22) 


where 


m l.inv = - XI [I A/+, | o/ + , -f | A/ 1 at] 


( 0 . 22 ) 

(0.23) 


The definition of A. R, R 1 , and A follow. The Jacobian of g with respect to q is 


(' (<Sr - C, ) 
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(0.24) 
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The similarity transformation matrices R and R 1 are defined as 


R = 


b sr 

a 2 
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2a 2 

2a 2 
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The diagonal matrix of eigenvalues of A i 

s defined by 






■ V 0 

0 0 

0 0 " 





0 V 

0 0 

0 0 




0 0 V 0 0 0 

0 0 0 V + a 0 0 

0 0 0 0 U - a 0 

0 0 0 0 0 V 


The variable c s is the mass fraction of species s where 

Ps 


Cs = 


(0.25) 


(0.26) 


(0.27 


The variables jj, <f>, and - y T are related to the partial derivatives of pressure with respect to q. 

3 = 


9 


dp 

R y Pr 

(0.2S) 

cf(pE) 

( >Cv ’ tr r=l ,rfr Mr 

Op 

R p< 

(0.29) 

0(pey) 

pC t , v M f 
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(0.30) 


Op ni„ n ( ., . A 

% ~ op s ~ 177 + 2 V" + v + ” /ir * ~ °'' A 

The variable a is the frozen speed of sound. 


RT„ a 


S, 


. 5=1 


* 2 = £ + I* II - « 2 - f* 2 - M’ 2 ] + Or v = (I + 0) - 

1 J f) 


(0.31) 


This definition of a 2 comes from the evaluation of the eigenvalues of A. The variable R is the 
universal gas constant, and M s is the molecular weight of species .s. 

The variables n y , and n~ are the .r-, y- , and ^-components of a unit vector normal to a 
computational cell face, and V is the normal component of velocity through the cell face, defined 
by 

V = V • ft = un x + vn y + trn z (0.32) 

I he two unit vectors / and m are defined such that /7, /, and m are mutually orthogonal (i.e., 
nj, - nim-i = = 0). The velocity components in the /- and m-directions, tangent to the 

cell face, are then defined by 


V = V * / = ul x + vl y + wL (0.33) 

W = V • m - nnij. + vm u + wm~ (0.3 1) 

In the matrices defined above, the first row and column correspond to the N s species con- 
tinuity equations. The subscript * refers to row .s and species .s, and the subscript r refers to 
column r and species r where both s and r vary from 1 to 1 1 in the present model. Note in 
equation (0.30) that T q = Ty when .s is an electron; otherwise, T q ~ T. Further details of the 
derivations may be found in reference 4. 


O.4. Formulation of Viscous Terms 

I he viscous stresses on a cell face with unit normal n in the ort hogonal directions ?7, /. and 
m are given by 


T~nn — Xl | 

( OU 

ov ow \ 

OU 


\0s„ 

Osi 0s m J 

+ 2 Hi — 
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(0.35 


f ov 

, du \ 



Tnl ~ Hi | 

\ 0s n 

+ 0s,J 


(0.30 

i 

( ow 

OV \ 



Tim — Hi | 


+ 0s m ) 


(0.37 


where l , V , and It are velocity components, and «s n , and s m are arc lengths in the ?7-. /-, and 
direct ions, respectively. The variables // and A are the viscosity coefficients. All transport 
properties at cell face / are obtained as linear averages of properties at adjacent cell centers. 

The component of shear stress acting in the ^-direction (* being a dummy variable for x , y . 
or ~) on a cell face with unit normal n can be expressed 

Tis 7~nn n s T Tnlls T (0.3N) 
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Substituting equations (0.35) to (0.37) into equation (0.3N). collecting terms, and simpli- 
fying (ref. 2) yields the following relation for shear stress in the ^-direction: 

(Os i)f> Os . OV OV Or) OU 0(\ 

r,„ = m { ¥i t« + 55-e + + S(7, + + W*) 

where a is a dummy variable for «. n, or u? corresponding to a = ;r. y. or ~. and terms like 
or ;// are shorthand notations for • n or V ;/ • /, respectively. A thin-layer approximation in 
the \ -coordinate direction (\ = //. or 0 simplifies equation (0.39) by neglecting derivatives 

in the other two coordinate directions. Consequently, 




0 \ 


+ 


i or \ 

m' 1 -) xn 


(0.40) 


where n refers to the direction normal to a constant y-surface. and the prime superscript refers 
to the thin-layer approximation. The Stokes relation, A = -§p, and geometric identities have 
also been used in the simplification of equation (0.39). The viscous terms on the other two 
coordinate surfaces are also neglected in the thin-layer approximation because their contribution 
to the overall momentum and energy balance is small. These approximations are valid so long 
as the boundary layer is relatively thin and the \-direction is approximately normal to the high 


gradient region . 

Mass diffusion and energy conduction contributions to the viscous terms are 
gradients normal to the cell face, for example, the gradient of / in the normal (n) 
expressed 

or = _ _ or r or or . 

= V ( T ) • n = —£n + — 1)11 + — 


Os 


cK 


dt) 


oc 


functions of 
direction is 

(0.41) 


The thin-layer approximation to equation (0.41) is expressed 


or or 

7j— = ~r\» 

o* r , 0\ 


(0.42) 


Derivatives in the \-direction are evaluated to second-order accuracy in computational space 
as follows: 



U L T ^ 11 L ~ M — | — 



" 1+1 


71+ 1 


"1+1 - U L -tUL = 



+ b-ui 

l 


- t > ul 

/+ 1 


For instance, the partial of u with respect to i) in the ^-direction is evaluated as follows (assuming 
a rectangular ordering of mesh points) : 


fOll\ _ "l.J+l./v ~ + "7+1,.7+I.A' ~ "/+ 1 — 1 ,/v 


The derivatives in the directions along the face (i.e., those derivatives neglected in the thin- 
layer approximation) have no functional dependence on the cell center. Therefore, the point- 
implicit treatment of the full Navier-Stokes equations is identical to the thin-layer Navier-Stokes 
equations. 
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Now, define h/ as a function of difference's evaluated using currently available data, for 
example and define h* ; as a function of differences using predicted values at. cell center 

L. for example These definitions permit the linearization of the viscous terms to be 

expressed as follows: 



W,/, - h/ — B; I J>q t 

h /+i,L = h/+i -f B/ + i jbc\j 

(0.43 

when 1 

_ u Kl <'Kl 

LL °<\1, V<lL 

R ^/+1.L dtf+l.L 

clq L ()q L 

(0.44) 

The point - 
ous section on 

implicit implementation of the viscous terms follows the example set 
the in viscid terms 

in the previ- 


XI [w+i./.^z+i “ h*x<7/j = XI [h/+i^/+i - h/(T/] + M/^vis^q/, 

(0.45) 

where 

Ml. vis — XI + Jii'Lcri] 

( 0.46) 


In the case of the thin-layer Navier-Stokes equat ions, the summation would only include one of 

the i-, j-. or A- directions, depending on the orientation of the computational coordinates with 
the body. 


0.5. Formulation of Source Terms 


0.5. 1. Species Conservation 

I ho mass rate of production of species s per unit volume is expressed as 


fVr 

= M s XI ~ a *.r) [Rf,r ~ Rb y r] ( 0 .4 7 ) 

r= 1 

where A r is the number of reactions; o jS , r and /3 SfJ . are the stoichiometric coefficients for reactants 
and products in the r-reaction. respectively; and R }%r and R b , r are the forward and backward 
reaction rates for the /-reaction, respectively. These rates are defined by 


A\„ 


R 


f .r — kf <r 


s— 1 



and 


v, 

Rb,r — h‘ b r | j 

5=1 



whore kj ,. and ki )r are the forward and backward reaction rate coefficients, respectively, defined 
in refeienee 1. and A s is the number of chemical species. Five different chemical kinetic models 
for air chemistry are supported within LAURA (in files kinetic. F and source. F) through 
the definition of kmodcl in gasjnodel.vars.strt. The default is kmwld = :j in which the 
equilibrium constants are taken from reference 34 and which correspond to a number density 



of lo 16 cm -3 . The forward reaction rates are taken from reference 40. Numerical difficulties 
associated with chemical source terms are alleviated by limiting the minimum and maximum 
values of temperature used to compute the reaction rate coefficients. The parameters (nun and 
(max are set to 1000 and 50 000, respectively, in air.F. which is a block data routine. As a 
converged solution is approached, the lower limit can usually be further diminished; however, 
experience with problems tested so far shows no significant effect on aerothermal loads. The 
upper limit is established to reflect the range of validity of the curve fits for thermodynamic 
properties. 

The reaction rate coefficients are explicit functions of T and T\ . Consequently, the Jacobian 
of d\ s with respect to q can be explicitly evaluated as follows: 

duj s tiCo s tiT O^s til v ( O.l s ) 

()q f tiq f Tr ^ tiT 7 v, q tiq, tiiy /, q tiqj 

where all derivatives with respect to qj are evaluated at. q k {k ± j). The differential relations 
between 7 and q and between l v and q can be expressed as 

pk v.tr dR 


pk'v.v (H \ 

0.5.2. Total Energy Conservation 

The radiative energy transport term Q ra a is treated in a purely explicit manner. Radiative 
energy transport has been calculated using the method of Hartung (ref. 29). which is based 
initially on converged, nonradiative, nonequilibrium flow field solutions. These radiative source 
terms are then held constant, while the governing equations are relaxed again. In cases of 
strong radiation, this relaxation process may require a slower introduction of the source through 
appropriate averaging of the old and new source terms (ref. 31). There is no point-implicit 
contribution from this term in the algorithm. 

0.5.3. Vibrational-Electronic Energy Conservation 

The vibrational-electronic energy source term u>y can be subdivided into three functionally 
distinct sets of terms. 


a 2 + r 2 -f w 2 


dp - Y, (c* - cr.s) dp a 


— ud(pu) - t'd (pv) - wd (put) + d ( pE ) - d(pty) 

A', 

= d (pe v ) - Y. tv,* dp s 



The first set, the reactive source terms in the first pair of braces of equation (0.51), is 
composed of terms that are proportional to either dt s or to (Rf, r ~ Rb.r)- I* 1 the first case, the 
proportionality factor. D s . represents the average vibrational energy per unit mass created or 
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destroyed through recombination or dissociation of molecules. In the simplest approximation, it 
is set equal to the average vibrational-electronic energy, ry, although more comprehensive treat- 
ments that model preferential dissociation of vibrationally excited molecules can be employed. 
In the second case, the proportionality factor, 7 r , represents the average translational energy per 
mole (mol.) lost by a free electron in freeing another electron from a neutral heavy particle in 
reaction r through the process of electron impact (elec .imp.) ionization. It is approximated by 
the ionization energy from an excited state of the target particle. Further details on these point s 
are available m references .'14 and 4. The point-implicit formulation of these terms treats the 
proportionality factor explicitly and the reaction rates implicitly according to equations (0.48) 
to (0.50). 

The second set, the relaxation terms in the second pair of braces in equation (0.51). mod- 
els the energy exchange between heavy particle translational-rotational modes and vibrational- 
electronic and electron translational modes. The first, term in these braces, which models the 
exchange between vibrational and heavy particle translational modes, can be approximated by 


E P* 


r t \S ~ f v.3 

< T a > 


pC’v; 


T - T v 
tv 


(0.52) 


where 


1 

T\’ 


E 

,s=niol. 


Ps 

d/s < T s > 


E 


Ps_ 

Ms 


(0.5.1) 


1 he approximations in equations (0.52) to (0.53) are made to reduce the number of thermody- 
namic and relaxation time variables to be carried through the calculation. Also, direct evaluation 
of the equilibrium value, r m Vs . is more cumbersome than working directly with the translational 
temperature 7. This approximation degenerates as the differences between T and Ty get very 
large, but it is believed to be consistent within the total context of approximations made in the 
two-temperature model. The vibrational relaxation time < r, > is related to a number density 
weighted correlation of Millikan and White (ref. 41) 


P T : 


MW 


N 

I 

i=i 


E "j ex P [ A wi ( T 1/3 - 0.0 15// 


E 

3=1, j^e 

an<l a high-temperature limiting correction of Park (ref. 34) 




T? = 

: (<!/*») 1 

so that 

where 

< t s >= T*’"' + rf 

/ \ 1/2 
4 - i !hd\ 

and 

— - 

’ s w 

f 220 (N 2 ) 


* ^ S,S — ^ 

129 (0 2 ) 

[ 168 (NO) 


(0.51) 


(0.55) 


(0.56) 
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The pressure p in equation (0.54) is in units of atmospheres. The two-temperature model should 
also have a. corresponding term relating the energy exchange of translational and electronic 
energy. This transfer has not yet been formally included in the present work; however, it should 
be noted that the driving potential in the present approximation is already based on both the 
vibrational and electronic energies. The second term in these braces in equation (0.51) models 
the direct exchange of translational energy between electrons and heavy particles. This exchange 
rate is generally much slower than the previous term. Both terms in this set are now proportional 
to the difference between the translational and vibrational temperatures, T - Ty. Here again, 
the point-implicit formulation of these terms treats the proportionality factor explicitly and the 
driving potential T - Ty implicitly according to equations (0.49) and (0.50). 

The third set, the field-dependent terms in the third pair of braces of equation (0.51 ), is the 
functions of properties at the cell center and at the neighboring cells. (The first two sets are 
functions only of properties at the cell center.) These terms include radiative energy transport, 
which is work done by the electric field on electrons and electron pressure flow work, combined 
into a single term. Radiative energy transport is treated explicitly, if at all. as described before. 
The other contribution to the field-dependent terms is also treated explicitly. In fact, in t he cases 
tested to date (where the maximum electron number densities were approximately 4 percent of 
the total number density), omission of this term has little effect on the flow field. 


0.5.4. Point-Implicit Relaxation of Source Term 

The source term in equation (0.0) can be approximately linearized in the following manner: 

J>j? +I = * l + M l ,shcMl (°- 57) 


where 


and the elements of Ml.src 


Ml.src 


0*i. 

(Hl 


are calculated as described above. 


(0.58) 


0.6. Averaging Procedure 


The variables at cell faces are evaluated as follows: 

(\di + d/j— i 


d, = 


C i + 1 


(0.59) 


where d is a dummy variable representing u, v. w, c s , //, ey, h„, and «v. s . (Only the aver- 
aged values of velocities and total enthalpy are required for perfect gas flows.) The weighting 
parameter is defined by 


C’i = ( — 
\PL - 1 


The variables ;4, d>, and T are computed using a. pressure-weighted average as defined below 
with dummy variable d. 

, didp-iipL + Pl-i) 

ill = — 

PlAl.-l + PL-\di. 

The variable c s .i required in the evaluation of q.,,/ is defined as 

RT, 


-- h.i - 


£ sj — n s j 


Ms 
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All quantities required for the evaluation of sound speed at the cell wall are now available. 
A lower limil on sound speed evaluated using cell wall averages, equal to the free-stream sound 
speed, has been applied to deal with difficult transients across st rong shocks in equilibrium and 
noiiequilibrium flows. 

This simple averaging procedure does not exactly satisfy Roe's property V for equilibrium 
and nonequilibrium flows. The pressure weighting averaging on ii can be shown to nearly satisfy 
Roes property V for strong shocks and equilibrium flow. Vinokur (ref. 12), Liu and Vinokur 
(ref. 4.5). and Grossman and Cinnella (ref. 4-1 ) have proposed averaging schemes that enforce 
Roe s property 1 . 1 hese formulations have not been investigated here. 


0.7. Geometrical Relations 


Ihe recommended, second-order-accurate formulations for face-centered metrics, which are 
required in the evaluation of the viscous dissipation terms across cell faces, are presented below. 


^ (.i.J.K 




^ I.j.l [■ 








^ O.j.k 


( 4-1.. /.A + 4.. /.A ) + (<T, y ^ + <4+! -A A ) 

lfi/„AA^/-l,.AA 

(4.J- 1,A + 4+ 1 1 ,/\ ) + /„/-|, A (<4.y A + Vi+iJ,K ) 

fi/.J-i.A 

^'.-A/v-t + 4 + l.J.A-l ) + ^/„AA -1 (<4,y/ x + (T, + , y/v - ) 
40/./,/ v 0/y A _, 

(4-1./.A + bb-i.j+i.A ) + f 1/- 1 „AA + ff/j+i . a ) 

TO/.j,aO/_ i 

JJ\ 

^ I 1 .A + <?I,j,K) -t- ft/,. /-I, A (<T/ ; A - -|- CT/ >/+ 1 /x ) 
^T-AA (4.J.A-1 + 4.j+i,A-i ) + 0/../.A- 1 (<?; , y v - + <T/J + i ,A ) 

4^/,j,aA2/,j,a-i 

^/../.A (^/-l-AA + ^/-1,.AA+1 ) + ftf-i.j.A (<4„At- + <4,.At-H ) 
^/..AA (<?/.■/-!.* + <?/,J-i,A-H ) + 0/,./-l,A + (T; , /A . + 1 ) 

4S1/,./,a^/,./-i,a' 

^/■J.A 1 + 4AJ,fe) + 0/../,A-l (<4.J.fc -f <T; y fc+) ) 

4fl/,J,A0/,J,A_l 


(0.60) 

(0.61) 

(0.62) 

(0.64) 

(0.61) 

(0.65) 

( 0 . 66 ) 

(0.67) 

(0.68) 


In the case of the thin-layer Navier-Stokes equations, only the vectors defined by equa- 
tions (0.60), (0.61), and (0.68) are required, depending on the orientation of the coordinate 
system. The dot product of these vectors with the corresponding unit, normal to the cell face 
(recall. \n = V \ • ii ) can be approximated as follows: 


s'A.J.A 

V n I,j,K 


O'-IJ.k 


^/4,A (fr<-l,J,A + 4,. A A' ) + 0 /- 1 ,J,K (ffj.j.A + oy+mAA ) 

O/.J.A («I,j-\,K + 07,j,A') + 0/.J-1.A (<^7J,A + ^/./-H.a) 

^/../.A (flV.J.A— 1 + ^/..AA-) + (*/„/, A-l + l ) 

40/,J,A^/,J,A-l 


(0.69) 

(0.70) 

(0.71) 


Another useful formulation in the programming of the thin-layer Navier-Stokes equations 
involves a geometric relation between the unit normal to a cell face and the gradient of the 
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computational coordinate that defines the cell face 


oc 

Vs ) i,J,K 

dy\ 

Vs ) ij'K 
V*/ i j.k 

where .s is a dummv variable for x, y . or z • 


(Z nn °k.u< 

(»/««*) Jj.K 

(C 


(0.72) 

(0.73) 

(0.74) 


0.8. Relaxation Algorithm 

The governing relaxation equation is obtained by combining the results of equations (0.6), 
(0.23). (0.4b), and (0.58) and taking the limit as time step M goes to infinity. Thus, 


= ri, 


(0.75) 


where M / is the point-implicit Jacobian given by 

Ml = c/jMljnv + r/„Mt,v is - OlMl.src (0,<b) 

and r is the right-hand-side solution (residual) vector given by 

rL = - ^ [(g/+i + h/+i ) cr; + i - (g/ + h; ) cti ] +^0/, ( 0 . 77 ) 

Relaxation factors are used to control stability and convergence. Numerical tests in reference 18 
indicate that underrelaxation is appropriate for the inviscid contribution to the residual, with 
r f . _> 1.5. Overrelaxation is appropriate for the viscous contribution to the residual with vf v > 
0.5 provided relaxation sweeps are across the boundary layer; otherwise, rf „ > 1. The viscous 
relaxation factor is automatically set to 1 for directions tangent to the sweep direction. 1 he 
lower limits yield the fastest convergence rates, but can lead to instabilities if the solution is far 
from convergence or if the point-implicit Jacobian is “frozen." as discussed below, for too long. 
It is sometimes necessary to choose rf t > 3 and rf v > 2 to get past some difficult transients in 
the early stages of the relaxation process which defy linear analysis. When these transients pass, 
it is then advisable to switch to the lower limits of t hese parameters to get the best convergence 
rate. Convergence can eventually stall at some point because of limit cycles associated with 
the minmod function in equation (0.17). This stalling can be alleviated by again increasing the 
relaxation factors. 

The solution vector n and the Jacobian Ml are evaluated using the latest available data. 
Consequently, the algorithm requires only a single level of storage. One can solve for ^q/ using 
Gaussian elimination. Numerical experiments have shown that pivoting is not required, and so 
the algorithm is easily vectorized. An LC factorization of the Jacobian can be saved (frozen) 
over large blocks of iterations ( 10 to 50, as defined by njeobian) to further reduce computational 
costs as the solution converges. The Jacobian will generally need to be updated every iteration 
early in the calculation, when rapid adjustment of the solution occurs. There is a large cost 
in computational memory required for the Jacobian freezing; however, the use of solid-state 
memory (see section 11.4) essentially eliminates this problem on CRAY class computers. 
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Oho final scaling can bo applied to tq, before computing q” +l to dampen potentially catas- 
trophic perturbations in the evolving solution. Define />•/ by 


k I = min 


{ sa f< PL 


(0.7S) 


where soft - 0.5 is presently the hard-coded value, and the standard definition of an L, norm 
is employed. The value of k/, is usually equal to 1; however, early in the relaxation process 
and occasionally in regions of very severe expansions, this parameter will engage to limit the 
computed solution as follows: 

q/ +l - q7, + kiMl (0.79) 

New values for 7 and T v are obtained through a Newton-Raphson iteration based on equa- 
tions (0.49) and (0.50). Thermodynamic properties and reaction rate coefficients are advanced 
every iteration based on these updated values of T and T v . Transport properties are updated 
every ntrnsprt iterations. 

I he strategy used to drive the right-hand side of equation (0.77) to zero should take advan- 
tage of the host computer architecture and the physics of the problem. Generally, the solution 
is relaxed one plane at a. time, and vector lengths are equal to the number of cells in a plane. 
Numerical tests indicate that relaxation sweeps which run from a wall across the boundary layer 
to the opposite boundary and then back again are the most efficient for the blunt-body problem. 
Effects of a perturbation at a wall are felt at the opposite wall after one sweep. Effects of a 
pei tin bat. ion at one cell in a plane parallel to the wall require A iterat ions to be felt bv a cell 
whoso index differs from the source cell by N . 

1 he ordering of the sweeps can be used to speed convergence, but in numerical tests per- 
formed to date, final, converged steady-state solution is not affected. Thus, one should be able 
to solve a laige number of cells using a massively parallel processing computer in which each cell 
(or small group of cells) is relaxed semi-independently of its neighbor cells (cell groups) using 
its own processor. The expression “semi-independently” means that a. cell (cell group) will need 
updated information from its neighbor cells (cell groups), but neither the order that it receives 
this information nor the lag time it takes for this information to arrive is critically important. 
As long as each processor has immediate access to some level of information from its neighbors 
(which could be stored locally), the execution stream could proceed uninterrupted in a parallel, 
asynchronous mode. A crude simulation of asynchronous iteration, discussed in reference 45. 
demonstrated that computational cells could be advanced in a random order without sacrifice 
of stability or convergence. 

Asynchronous iteration has been tested on a four- processor CRAY 2 and an eight -processor 
CRAY Y-MP in reference 18. In these tests, the flow domains were subdivided into partitions 
with a single task assigned to each partition. Partition boundaries are dynamically adjusted 
to concentrate relaxation sweeps in the regions that are slowest to converge. Because no syn- 
chronization is required, all tasks (processors) can execute throughout the computation without 
interruption. A comparison of convergence histories for the solution of hypersonic flow in ther- 
mochemical nonequilibrium over an axisymmetric body is shown for a single task and a six-task, 
adaptive partition test, in figure 0.2. The symbols show the error norm for each individual task 
of the six-task run. The solid line shows the total error norm for the six-task run, and the dashed 
line shows the error norm for the single task run. Adaptive partitioning has allowed the six-task 
case to converge to a lower error norm than the single task case for the same amount of CPU 
time. Furthermore, the actual elapsed time for the six-task case would be a factor of 0 smaller 
than for the single task case on a dedicated machine. 


201 



CPU time, 6 

Figure 0.2. Convergence histories for single-task and six-task, adaptive partitioned algorithms 
applied to problem of nonequilibrium, hypersonic flow over blunt, axisymrnetrie body. 



Appendix P 


FORTRAN Variables Discussed in This 
Manual 


I he following FORTRAN variables are discussed in t his document * 


attack 

angle of at tack, deg 

ax far 

axial stretching factor for grid (Iconic = 1 ) 

h 

axial shape parameter for conic geometry 

b( tayrel 

control parameter for grid alignment 

by as 

perfect gas ji % where ti = 7-1 

epsa 

coefficient for eigenvalue limiter ( e 0 ) 

cpt 

wall temperature relaxation factor 

rpO 

control parameter for grid alignment (section i 1.1.1) 

( ml 

error criteria for doubling grid density in 
body-normal direction 

fctrjmp 

factor for property jump that identifies shock location 
(section 11.1.1) 

fsh 

Mr 

fraction of grid within shock layer (section 11.1.1) 

fraction of cells to be used in grid stretching region 
(section 11.1.1) 

firs 

time limit for present laura run, hr 

iabsciy 

flag for eigenvalue limiter scaling options 

iafe 

flag for aerobrake geometry options 

lay , jay. kay 

number of cells in jf- , and /.-directions, respectively, for 

Block A 

t«<if> imf 

dimensions for cross terms of full Navier-Stokes equations: 
required for igovern = 2 only 

iblk, jblk , kblk 

number of cells in j-, and ^-directions, respectively, for 

given block 

ic 

number of cells used in axial direction for cap of 
blunted-cone or wedge. 

i charge 

toggle for electron continuity equation 

icrv 

flag for equilibrium air curve-fit options 

i froze n 

toggle for chemical and thermal source term 

iyovern 

flag for governing equation options 

imptemp 

toggle for temperature dependence of reaction rates 



isjs 

isrf 

issd 

iterg 

itherm 

itypc 

run it 

iupwind 

iris, jvii s, kvis 

3*rf 

jtyp< 

jumpflag 

kmodel 

konic 

k'str 


working array size (equal to maxi in uni iiumbei of cell 
walls in planes perpendicular to sweep direction) 
defined as maximum of all blocks 
maximum value for first index of any active wall 
boundary 

toggle for solid-state device (SSD) on CRAY architectures 

maximum number of iterations for this run 

flag for thermal state of nonequilibrium air 

boundary type of given side of given block 

flag for geometry unit options 

flag for total variation diminishing (TVD) limiter options 
j-, and ^-direction toggles for thin-layer viscous terms 
(0 = off, 1 = on) 

maximum value for second index of any active wall 
boundary 

flag for wall catalysis options 

flag for property used to determine shock location 

flag for kinetic model options 

flag for conic geometry options 

number of cells to be used in grid stretching region 


Istrt 
Is top 
LMAX 

machine 

mapepu 


(section 11.1.1 ) 

starting index (in sweep direction) of given partition 
( 1 < Istrt < 1st op) 

stopping index (in sweep direction) of given partition 
( Istrt < Istop < LMAX) 

number of cells in sweep direction for given block 
flag for machine architecture options 
task number to which partition is assigned 
( 1 < mapepu < rnaxcpu ) 


rnaxepu maximum number of piocessors available 

(hard-coded to maxcpv — 16 in file btask_comm. inc) 
maxi* maxj , maxk maximum of iblk n , jblk n , and khlk n , respectively (n — 1. nhlo(ks) 


rnaxn loves 
rnbk 

movegrd 

rntaska 

nbk , nblk 

nblocks 

ndim 

fidinib 

neq 

new job 
ngas 
nj cob tan 
nord 
nordbc 
u p roc n i x 


used only for nturb > 0 

maximum number of grid adjustments for this run 

sweep direction for given partition 

number of iterations between grid adjustments 

toggle for multitasking with adaptive partitioning 

computational block containing given partition 

number of computational blocks 

flag for flow dimensionality options 

flag for body dimensionality options 

number of governing equations being solved 

flag for initialization options 

flag for gas model options 

number of iterations between Jacobian updates 
flag for governing equation spatial accuracy options 
flag for boundary condition spatial accuracy options 
number of processors available on given machine 
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nprors 
nr z 

ns 

lisp 

nsrf 

nsz 

ntrnsprt 
nlurb 
p ra nd 1 1 
reeel I 
n fan a 

nflen 

rfinv 

rfvis 

rflngt.li 

ri 

rinfb 

most 

rxz 

str 

temp 
temp be 
trmpv 
the 
tin/ 
t trail 
u, r\ tr 

uinf vinf win} 
vinfb 

vtgas , id gas 
wgas 

xeg< peg, zcg 

yaw 

zmax 


number of processors available for this LAURA run 
maximum number of reactions defined by any kinetic model in 
LAURA; currently, nr: = 26 

total number of active species (Ay) ( I < ns < 1 1 ); 
ns = 1 for nx/as 2 

total number of species groups that serve as collision partners 
in LAURA; currently, nsp = 16 

total number of solid surfaces in all computational blocks 
total number of species defined in LAURA: 
currently, nsz ~ li 

number of iterations between transport property updates 
flag for turbulence options 
Prandtl number 

ceil Reynolds number (section 11.1.1) 

leference area for ('valuation of aerodynamic coefficients, in 
units specified via iunit 

reference length for evaluation of aerodynamic coefficients, in 
units specified via iunit 
inviscid relaxation factor (?/■) 
viscous relaxation factor (rf v ) 

conversion factor, from units specified via iunit to meters 
species densities, nondimensionalized by 
free-stream density, kg/m 3 

body nose radius of curvature (tf/vU in units specified via iunit 
body nose radius of curvature in symmetry plane ( Il r: ) , in units 
specified via iunit 

surface distance from nose to onset of transition ( nturb / 0), in 

units specified via iunit 

translational-rotational temperature. K 

flag for wall temperature boundary condition options 

vibrational-electron-electronic excitation temperature, K 

body half angle (konic — 1 ), deg 

free-stream temperature, K 

wall temperature, K 

velocity components in y and ^-directions, respectively, 
nondimensionalized by V <yCl 

W-, r-, and u?-eomponents of free-stream velocity 

free-stream velocity, m/s 

coefficients for Sutherland’s law 

molecular weight of air, kg/kg-mol 

x~, y and ^-location of reference center for aerodynamic 

moments, in units specified via iunit 

yaw angle, deg 

body length (konic = 1), in units specified via iunit 
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Appendix Q 

FORTRAN Flags Changed Through data 


Noto that the default values are indicated for those parameters that are automatically defined 
by LAURA as follows: 


Eigenvalue limiter scaling options: 


{ () (normal limiter) 

1 (scaled limiter {default}) 


Toggle for chemical and thermal source term ( nejas - 2): 


i frozen 


0 (chemically and thermally frozen flow) 

1 (nonequilibrium flow {default}) 


Options for spatial accuracy of governing equations: 


novel — 


1 (first-order accuracy) 

2 (second-order accuracy) 
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Appendix R 


FORTRAN Flags Changed Through stArt 


I he following FORTRAN flags are changed through stArt: 


Aerobrake ( new job — 2) geometry options: 
iaf( ~ 


0 (Aeroassist, Flight. Experiment (AFE) aerobrake (ref. 20)) 

1 (hemisphere) 

2 ( customized aerobrake ) 


Equilibrium air ( ngas ~ 1) curve-fit options: 


MTV = 


1 (Vinokur in Liu and Vinokur (ref. 19)) 

2 (Tannehill in Srinivasan et al. (ref. 20)) 


Options for governing equations: 


0 (Euler) 

Ujovern = { 1 (thin-laver Navier-Stokes (TL N-S)) 
2 (full Navier-Stokes (N-S)) 


Thermal state of nonequilibrium air ( ngas = 2): 

itlierw — 

Opt ions for geometry units: 


1 (thermal equilibrium ( 1— T ) ) 

2 (thermal nonequilibrium (2-T)) 


in nit ~ < 


0 (meters) 

1 (centimeters) 

2 ( feet ) 

3 (inches) 

4 (other units) 


Options for wall catalysis: 

( 0 (lion-catalytic) 

1 ( “super-catalytic” ) 


jtype = { 


2 1 

3 


> (catalytic to ions) < 


f (non-catalytic to neutrals) 
(Stewart et al. (ref. 21 )) ) 
(Zoby et al. (ref. 22)) 
(Scott et al. (ref. 23)) 
(recombination of atoms 


finite catalysis 
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Conic options (for axisyrnmetric body): 

1 (hyperboloid) 

2 (paraboloid) 

3 (ellipsoidally- blunted cone) 

1 ( spherically-blunted cone ) 

Conic options (for two-dimensional body): 

1 (hyperbola) 
konic = 2 (parabola) 

3 (blunted wedge) 

(Ionic options (for three-dimensional body): 

1 (hyperboloid) 

Iconic = 2 ( paraboloid ) 

3 (blunted cone) 

Flow dimensionality options: 

1 (axisyrnmetric) 
ndim = 2 (two dimensional ) 

3 (three dimensional) 

Body dimensionality options: 

1 (axisyrnmetric) 
ndirnb— 2 (two dimensional) 

3 (three dimensional) 

Initialization options: 

0 (externally generated RESTART. in file) 
newjob =■ 1 (flow about conic (cone/wedge, paraboloid)) 

2 (flow about generic aerobrake) 

Gas model options: 

0 (perfect gas (PG)) 
ngas = 1 (equilibrium air ( EQ ) ) 

2 (chemical nonequilibrium (NONEQ)) 

Turbulence options (for ngas ^ 2): 

! 0 (none (laminar flow)) 

1 (Cebeci-Smith (in ref. 24) model) 

2 (Baldwin-Lomax (in ref. 25) model) 

Options for wall temperature (T w ) boundary condition: 

0 (constant 7^,,) 

tempbc - < 1 (specified T w variation) 

2 (radiative equilibrium T w ) 
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Appendix S 


FORTRAN Flags Changed Through File Edits 


Note* that the file of residence for each parameter is provided. Default values are indicated 
for those parameters that are automatically defined by LAURA as follows: 


toggle for electron continuity equation ( ngas ~ 2), located in source_vars . strt: 


i charge 


0 (solution of electron continuity equation) 

1 ( h f — ^ h s {default.}) 

s = ions 


I^ggl*' tempei a.tuie dependence of reaction rates (uejas — 2), located in source_vars . strt: 


i mp temp = 


0 (explicit treatment of dependence) 

1 (implicit treatment of dependence {default.}) 


Toggle for solid-state device (SSD) on CRAY architectures, located in issd_assn . strt: 


0 (no SSD {default}) 

1 (SSD) 


Options for TVI) limiter, located in iupwincLassn . strt: 


iupwind 


0 (symmetric limiter (eq. (3.8(c)). ref. 2) {default}) 
< 1 (upwind- biased limiter (ref. 39)) 

2 (symmetric limiter (eq. (3.8(b)), ref. 2)) 


Options for property used to determine shock location in algnshk.F (section 
algnshk.vars . strt: 


jumpflag = 


0 

1 

2 


3 


(fixed outer boundary) 
(pressure (p) {default } ) 
(density (/>)) 
(temperature (T)) 


11.1.1). located in 


Kinetic model options (for ngas = 2), located in gas_model.vars . strt: 


krnodel = < 


1 

2 

3 

4 


(Dunn and Kang (ref. 46) model) 

(Park (ref. 6) model) 

(Park (ref. 40) forward rates; A, v from reference 34 {default}) 
(Kang and Dunn (ref. 46) forward rates; Gupta A',, (ref. 47)) 
(Park (ref. 40) forward rates; Gupta et al. K, q (ref. 47)) 
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Toggle for multitasking with adaptive partitioning, located in mtaska_assn . strt: 


mtaska — 


0 (no adaptive partitioning {default}) 

1 (adaptive partitioning) 


Options for spatial accuracy oi surface and outflow boundary condit ions, located in nordbc_assn. strt 


nordbc = 


1 (first-order accuracy {default}) 

2 (second-order accuracy) 
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